home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / swmgr.z / swmgr
Encoding:
Text File  |  2002-10-03  |  121.3 KB  |  2,377 lines

  1.  
  2.  
  3.  
  4. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      swmgr, SoftwareManager - software manager
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      sssswwwwmmmmggggrrrr [ ----nnnnNNNN ] [ ----ffff source ] [ ----mmmm hardware====value ] [ ----rrrr target ]
  13.           [ ----uuuu action ] [ ----FFFF selections-file ] [ ----IIII selection ]
  14.           [ ----RRRR selection ] [ ----KKKK selection ] [ ----XXXX file ] [ ----YYYY file ]
  15.           [ ----VVVV preference::::value ] [ -------- X-command-line-option ... ]
  16.  
  17.      SSSSooooffffttttwwwwaaaarrrreeeeMMMMaaaannnnaaaaggggeeeerrrr [ swmgr_options ]
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _s_w_m_g_r is the graphical tool used to install, remove, and browse software
  21.      distributed by Silicon Graphics.
  22.  
  23.      _S_o_f_t_w_a_r_e_M_a_n_a_g_e_r invokes _s_w_m_g_r with the arguments provided after prompting
  24.      for the root password if one is necessary.
  25.  
  26.      The ----ffff option specifies the location of new software to be installed.
  27.      The _s_o_u_r_c_e argument is either a single _d_i_s_t_r_i_b_u_t_i_o_n, or a directory
  28.      containing one or more distributions.  Software distributions are in a
  29.      format defined by Silicon Graphics and that can be read only by _s_w_m_g_r and
  30.      _i_n_s_t(1M).  See the _i_n_s_t__d_e_v product for creating your own software
  31.      distributions.
  32.  
  33.      _s_w_m_g_r can read the distribution from a local drive (tape, CD-ROM or
  34.      disk), or from a remote directory, web site, or drive connected to the
  35.      same network as your workstation.  See the _i_n_s_t(_1_M) manual page for a
  36.      full description of possible distribution media.
  37.  
  38.      The command line options are:
  39.  
  40.      ----ffff _s_o_u_r_c_e
  41.           Specify the location of the software distribution.  The format of
  42.           _s_o_u_r_c_e depends on the location of the distribution and other
  43.           factors.  Multiple -f arguments are permitted.  The possibilities
  44.           are:
  45.  
  46.           ttttaaaappppeeee            local tape drive
  47.  
  48.           ////ddddeeeevvvv////nnnnrrrrttttaaaappppeeee     local tape drive
  49.  
  50.           ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt     local CD-ROM drive
  51.  
  52.           _d_i_s_t_d_i_r         local distribution directory _d_i_s_t_d_i_r
  53.  
  54.           ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////_p_r_o_d_u_c_t
  55.                           installing just _p_r_o_d_u_c_t from a local CD-ROM drive
  56.  
  57.           _d_i_s_t_d_i_r////_p_r_o_d_u_c_t installing just _p_r_o_d_u_c_t from a local distribution
  58.                           directory
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  71.  
  72.  
  73.  
  74.           nnnnoooonnnneeee            for browsing or removing installed software only
  75.  
  76.           _s_e_r_v_e_r::::////ddddeeeevvvv////ttttaaaappppeeee
  77.                           tape drive on a remote workstation whose hostname is
  78.                           _s_e_r_v_e_r
  79.  
  80.           _s_e_r_v_e_r::::_C_D_d_i_r////ddddiiiisssstttt
  81.                           CD-ROM drive with the CD mounted at _C_D_d_i_r on a
  82.                           remote workstation whose hostname is _s_e_r_v_e_r
  83.  
  84.           _s_e_r_v_e_r::::_d_i_s_t_d_i_r  distribution directory _d_i_s_t_d_i_r on a remote
  85.                           workstation whose hostname is _s_e_r_v_e_r
  86.  
  87.           _s_e_r_v_e_r::::_C_D_d_i_r////ddddiiiisssstttt////_p_r_o_d_u_c_t
  88.                           installing just _p_r_o_d_u_c_t from a CD mounted at _C_D_d_i_r
  89.                           on a remote workstation whose hostname is _s_e_r_v_e_r
  90.  
  91.           _s_e_r_v_e_r::::_d_i_s_t_d_i_r////_p_r_o_d_u_c_t
  92.                           installing just _p_r_o_d_u_c_t from a distribution
  93.                           directory _d_i_s_t_d_i_r on a remote workstation whose
  94.                           hostname is _s_e_r_v_e_r
  95.  
  96.           _h_t_t_p://_s_e_r_v_e_r/_d_i_s_t_d_i_r/
  97.                           installing from a web site.  This functionality
  98.                           requires that the libwio.so library be installed on
  99.                           the local system.
  100.  
  101.           _h_t_t_p://_s_e_r_v_e_r/_d_i_s_t_d_i_r/_f_i_l_e._t_a_r_d_i_s_t
  102.                           download the tardist file, and unpack into a local
  103.                           temporary directory before installing.  Tardist
  104.                           files may be used in conjunction with a .inst
  105.                           selections file so that installations initiated from
  106.                           a web browser will not block the browser during the
  107.                           download.  See -F, TARDIST and SELECTIONS FILE
  108.                           below.
  109.  
  110.           When using a remote distribution source, you can prepend _u_s_e_r@@@@ to
  111.           specify a user ID other than guest as discussed above.  For example,
  112.           to use a remote tape drive on bigserver as user iiiinnnnssssttttuuuusssseeeerrrr, the ----ffff
  113.           argument is iiiinnnnssssttttuuuusssseeeerrrr@@@@bbbbiiiiggggsssseeeerrrrvvvveeeerrrr::::////ddddeeeevvvv////ttttaaaappppeeee.
  114.  
  115.      ----rrrr _t_a_r_g_e_t
  116.           Set the effective root directory in which the new software will be
  117.           installed.  By default, this is ////.  This option is used to specify
  118.           the root of a virtual IRIX tree for diskless prototype trees.
  119.  
  120.           The -r option may also be used to install software somewhere other
  121.           than the default location.  However, by changing the effective root
  122.           directory, the normal installation history database in /var/inst
  123.           will not be used, and inst may not be able to to correctly resolve
  124.           prerequisite conflicts.  Therefore when attempting to manage disk
  125.           space, it is usually preferable to avoid using the -r option, and
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  137.  
  138.  
  139.  
  140.           instead create a symbolic link from the system disk to an option
  141.           drive before running inst or Software Manager.
  142.  
  143.           For example, if a product installs files into the directory
  144.           /usr/share/foo, you can make a symbolic link (see ln(1)) from
  145.           /usr/share/foo to /disk2/usr/share/foo, and then run inst or
  146.           Software Manager without the -r option to install the product's
  147.           files into /disk2.  A record of the installation will still be
  148.           maintained under /var/inst.
  149.  
  150.           The -r option cannot be used to create a bootable system disk for
  151.           the same or an alternate OS or machine.  Such a disk is normally
  152.           created by running inst in the miniroot environment.
  153.  
  154.      ----IIII _s_e_l_e_c_t_i_o_n
  155.           Specify products or subsystems to install, where _s_e_l_e_c_t_i_o_n is a
  156.           product name, or other expression accepted by the _i_n_s_t iiiinnnnssssttttaaaallllllll
  157.           command.  Multiple expressions can be specified by using a comma
  158.           separated list or by using multiple ----IIII options.
  159.  
  160.      ----RRRR _s_e_l_e_c_t_i_o_n
  161.           Specify products or subsystems to remove, where _s_e_l_e_c_t_i_o_n is a
  162.           product name, or other expression accepted by the _i_n_s_t rrrreeeemmmmoooovvvveeee
  163.           command.  Multiple expressions can be specified by using a comma
  164.           separated list or by using multiple ----RRRR options.
  165.  
  166.      ----KKKK _s_e_l_e_c_t_i_o_n
  167.           Specify products to keep (don't install or remove), where _s_e_l_e_c_t_i_o_n
  168.           is a product name, or other expression accepted by the _i_n_s_t kkkkeeeeeeeepppp
  169.           command.  Multiple expressions can be specified by using a comma
  170.           separated list or by using multiple ----KKKK options.
  171.  
  172.      ----VVVV _p_r_e_f_e_r_e_n_c_e::::_v_a_l_u_e
  173.           Initialize _p_r_e_f_e_r_e_n_c_e to _v_a_l_u_e.  See PREFERENCES.
  174.  
  175.      ----FFFF _s_e_l_e_c_t_i_o_n_s-_f_i_l_e
  176.           The _s_e_l_e_c_t_i_o_n_s-_f_i_l_e is used to pre-select subsystems for
  177.           installation or removal.  A remote selections file is allowed using
  178.           user@host:file or http://server/selections.inst.  By convention
  179.           selections files located on the web have a .inst suffix.  See
  180.           SELECTIONS FILE below for complete syntax.
  181.  
  182.      ----cccc _f_i_l_e
  183.           Causes inst to execute commands in the order that they appear in
  184.           _f_i_l_e.  Unless the quit command is used, inst will resume in
  185.           interactive mode after processing the file.  Control-C can be used
  186.           to summon the interrupt menu.  Normally Inst will stop processing
  187.           the file if an error occurs, and present the interactive menu,
  188.           unless the aaaabbbboooorrrrtttt____oooonnnn____eeeerrrrrrrroooorrrr preference is set to off.  This option is
  189.           ignored by SoftwareManager.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      ----MMMM   Do not display _i_n_s_t output using its built-in pager, and do not show
  207.           percent-done messages.  Equivalent to setting ppppaaaaggggeeee____oooouuuuttttppppuuuutttt====ooooffffffff and
  208.           sssshhhhoooowwww____ppppeeeerrrrcccceeeennnntttt____ddddoooonnnneeee====ooooffffffff.
  209.  
  210.      ----EEEE   Invoke iiiinnnnsssstttt____tttteeeerrrrsssseeee____mmmmooooddddeeee.  Provides reduced output for scripting.
  211.           Equivalent to setting iiiinnnnsssstttt____tttteeeerrrrsssseeee____mmmmooooddddeeee====oooonnnn in the shell environment
  212.           before invoking _i_n_s_t.  If set on, it minimizes _i_n_s_t output:  most
  213.           normal status and progress messages are suppressed unless explicitly
  214.           asked for, but any warnings, errors, and explicitly requested output
  215.           still appear.  See the description of the preference iiiinnnnsssstttt____tttteeeerrrrsssseeee____mmmmooooddddeeee
  216.           within _i_n_s_t or _s_w_m_g_r for more information.
  217.  
  218.      ----PPPP _f_i_l_e
  219.           Specify _f_i_l_e to be pppprrrreeeecccciiiioooouuuussss.  See PREFERENCES.
  220.  
  221.      ----NNNN   Disables space-checking by initializing the _s_p_a_c_e__c_h_e_c_k preference
  222.           to _o_f_f.  See PREFERENCES.
  223.  
  224.      ----uuuu _a_c_t_i_o_n
  225.           Specify the type of subsystems to select for installation.  The
  226.           possible actions are:
  227.  
  228.           nnnneeeewwww               Select all new products for installation.
  229.  
  230.           uuuuppppggggrrrraaaaddddeeee           Select all upgrade products for installation.
  231.  
  232.           uuuuppppggggrrrraaaaddddeeee____aaaannnndddd____nnnneeeewwww   Select all new and upgrade products for
  233.                             installation.
  234.  
  235.           uuuuppppggggrrrraaaaddddeeee____oooorrrr____nnnneeeewwww    Select upgrade (or new, if no upgrades) products
  236.                             for installation.
  237.  
  238.           uuuuppppggggrrrraaaaddddeeee____aaaannnndddd____rrrrnnnnddddssss____oooorrrr____nnnneeeewwww
  239.                             Select upgrade and related new default subsystems
  240.                             (or new defaults, if no upgrades, no downgrades
  241.                             and no same) for installation.  (This is the
  242.                             default action.)
  243.  
  244.           aaaallllllll               Select all products for installation.
  245.  
  246.      ----XXXX _f_i_l_e
  247.           Exclude _f_i_l_e during installations and removals.  If _f_i_l_e is a
  248.           directory, its descendents are also excluded.  Multiple ----XXXX options
  249.           are permitted, however wildcards are not.  To quickly rebuild a
  250.           corrupted installation history, re-install the same versions of your
  251.           existing software using -_X/ (no files will be touched).  See also
  252.           the _e_x_c_l_u_s_i_o_n_s preference.
  253.  
  254.      ----YYYY _f_i_l_e
  255.           Install only _f_i_l_e during installations and removals.  If _f_i_l_e is a
  256.           directory, only it and its descendents are installed or removed.
  257.           Multiple ----YYYY options are permitted, however wildcards are not.  See
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  269.  
  270.  
  271.  
  272.           the _r_e_s_t_r_i_c_t_i_o_n_s preference.
  273.  
  274.      ----UUUU   Run the tool in _e_x_t_r_a_c_t__m_o_d_e, useful for recreating a source tree
  275.           from a set of images produced by _g_e_n_d_i_s_t(1M).  See PREFERENCES.
  276.  
  277.      ----TTTT   Run the tool in _s_y_m_l_i_n_k__m_o_d_e, useful for creating a tree of symbolic
  278.           links, instead of regular files.  See PREFERENCES.
  279.  
  280.      ----nnnn   Initialize the _d_r_y_r_u_n preference to _o_n.  See PREFERENCES.
  281.  
  282.      ----CCCC   Install software for all architectures that support diskless
  283.           clients.  This is normally used only when installing (on the server)
  284.           the share tree for diskless clients.  It will only work correctly
  285.           with products designed for use with diskless clients (that is, the
  286.           different hardware-specific files are installed with different names
  287.           for each hardware type).  Some products install files with the same
  288.           name, regardless of architecture, and this option will not allow
  289.           such products to install all files in a unique way.
  290.  
  291.           Normally used by _s_h_a_r_e__i_n_s_t(1M), this option is used to install
  292.           sharable software (including hardware-specific files) for all
  293.           architectures listed in the file indicated by the _m_a_c_h__c_l_a_s_s_f_i_l_e
  294.           preference.  See PREFERENCES.
  295.  
  296.      ----ssss   Install shared software for use by diskless clients.  This option is
  297.           normally used only by _s_h_a_r_e__i_n_s_t(1M) when constructing a share-tree
  298.           for diskless clients.
  299.  
  300.      ----SSSS _s_h_a_r_e_t_r_e_e
  301.           Install software for diskless client, and specify the shared tree.
  302.           This option is normally used only by _c_l_i_e_n_t__i_n_s_t(1M) when installing
  303.           the diskless client-specific software.  When this option is given
  304.           _i_n_s_t installs the non-sharable software that is used exclusively by
  305.           an individual diskless client.
  306.  
  307.      ----HHHH   This option causes _i_n_s_t to print the hardware variables and then
  308.           exit.  See the ----mmmm option, and the aaaaddddmmmmiiiinnnn hhhhaaaarrrrddddwwwwaaaarrrreeee command of inst.
  309.  
  310.      ----ZZZZ   Re-writes the installation history in /var/inst using the IRIX 6.2
  311.           inst format.  Inst will refuse to perform this operation if any
  312.           overlay maintenance products are installed.  This option is silently
  313.           ignored by _s_w_m_g_r.
  314.  
  315.      ----mmmm _h_a_r_d_w_a_r_e====_v_a_l_u_e
  316.           Specify an alternate type of hardware for the installation.  See the
  317.           _i_n_s_t(_1_M) manual page for a full description of this option.
  318.  
  319. SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  320.      Some inst commands accept keyword arguments as shorthand ways of choosing
  321.      groups of subsystems.  These keywords may also be used with the -I, -R
  322.      and -K command-line otions, in selections files (-F), in command files
  323.      (-c), and in the SoftwareManager command-pane.
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  335.  
  336.  
  337.  
  338.      If more than one keyword is given within a single install, remove, keep,
  339.      etc. command, the intersection of the keywords is taken.  This means that
  340.      the command applies only to subsystems satisfying all of the keywords.
  341.  
  342.      The following list gives each keyword, its abbreviation if it has one,
  343.      and a brief description.
  344.  
  345.      aaaallllllll,,,, aaaa              All subsystems in "showprods -a" output plus all
  346.                          subsystems in the software distribution.
  347.  
  348.      cccclllliiiieeeennnnttttoooonnnnllllyyyy,,,, cccc       All subsystems that are only for nfs-client installs
  349.                          (see share_inst(1M)).
  350.  
  351.      ddddeeeeffffaaaauuuulllltttt,,,, dddd          All subsystems in the distribution that are marked
  352.                          with "d".
  353.  
  354.      ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn        All subsytems in the current distribution(s).
  355.  
  356.      ddddiiiisssstttt::::               When followed by a colon (::::), selects all subsytems
  357.                          in any distribution whose name contains the string
  358.                          ddddiiiisssstttt.  Useful when multiple distributions are open.
  359.  
  360.      ddddoooowwwwnnnnggggrrrraaaaddddeeee,,,, DDDD        All subsystems that have a version installed that is
  361.                          newer than the version in the software distribution.
  362.  
  363.      hhhhaaaarrrrddddwwwwaaaarrrreeee,,,, hhhh         All subsystems containing hardware-specific files.
  364.  
  365.      iiiinnnnssssttttaaaallllllll,,,, iiii          All subsystems that are selected for installation.
  366.  
  367.      iiiinnnnssssttttaaaallllllllaaaabbbblllleeee,,,, AAAA      All subsystems in the software distribution, except
  368.                          certain patches, hardware-specific and clientonly
  369.                          subsystems that are inappropriate for the current
  370.                          target.
  371.  
  372.      uuuunnnniiiinnnnssssttttaaaallllllllaaaabbbblllleeee,,,, XXXX    All subsystems in the software distribution that are
  373.                          inappropriate for the current target.
  374.  
  375.      ccccoooonnnnfffflllliiiiccccttttiiiinnnngggg,,,, CCCC      All subsystems currently selected for installation or
  376.                          removal, that are causing conflicts.  Useful with
  377.                          "keep conflicting".
  378.  
  379.      pppprrrreeeerrrreeeeqqqqssss             The minimal set of unselected distribution subsystems
  380.                          that will resolve all current prereq conflicts.
  381.                          Useful with "install prereqs".
  382.  
  383.      iiiinnnnssssttttaaaalllllllleeeedddd,,,, IIII        All subsystems that are installed on the target.
  384.  
  385.      kkkkeeeeeeeepppp,,,, kkkk             All installed subsystems that are not selected for
  386.                          re-installation, replacement or removal.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  401.  
  402.  
  403.  
  404.      rrrreeeebbbbooooooootttt,,,, bbbb           All subsystems that require a reboot to complete
  405.                          installation.
  406.  
  407.      nnnneeeewwww,,,, NNNN,,,, nnnn           All subsystems that aren't installed, and aren't
  408.                          upgrades or downgrades of something installed.
  409.  
  410.      nnnnoooottttiiiinnnnssssttttaaaalllllllleeeedddd        All subsystems on the target that have neither been
  411.                          installed nor removed.
  412.  
  413.      ppppaaaattttcccchhhheeeessss             All patches in the distribution.
  414.  
  415.      ppppaaaattttcccchhhhuuuuppppggggrrrraaaaddddeeee,,,, PPPP     All patches in the distribution that are upgrades to
  416.                          installed patches.
  417.  
  418.      rrrreeeemmmmoooovvvvaaaabbbblllleeee,,,, LLLL        All of the installed subsystems that can be selected
  419.                          for removal.
  420.  
  421.      rrrreeeemmmmoooovvvveeee,,,, rrrr           All of the subsystems that are selected for removal.
  422.  
  423.      rrrreeeemmmmoooovvvveeeedddd,,,, RRRR          All subsystems that were once installed.
  424.  
  425.      rrrreeeeqqqquuuuiiiirrrreeeedddd,,,, qqqq         All of the subsystems that are required for proper
  426.                          operation of the workstation.
  427.  
  428.      ssssaaaammmmeeee,,,, SSSS,,,, ssss          All subsystems that have an identical version
  429.                          installed.
  430.  
  431.      ssssttttaaaannnnddddaaaarrrrdddd            This keyword is useful for performing a software
  432.                          upgrade, by using the command sequence kkkkeeeeeeeepppp ****
  433.                          followed by iiiinnnnssssttttaaaallllllll ssssttttaaaannnnddddaaaarrrrdddd.  In Software Manager,
  434.                          an equivalent option is available on the Install
  435.                          menu.  If the distribution contains any related
  436.                          (same, upgrade or downgrade) subsystems, then
  437.                          standard refers to upgrade subsystems plus new,
  438.                          default sibling subsystems (in the same product) that
  439.                          were not part of the product the last time they were
  440.                          installed.  However if the distribution contains no
  441.                          related products (in other words, all products are
  442.                          new) then standard will select all default
  443.                          subsystems.  Finally, standard will also include any
  444.                          prerequisite products (see pppprrrreeeerrrreeeeqqqqssss) but not overlay
  445.                          subsystems whose base subsystems are missing (see
  446.                          iiiinnnnccccoooommmmpppplllleeeetttteeeeoooovvvveeeerrrrllllaaaayyyyssss).  Standard will not select
  447.                          downgrade or currently installed (same) subsystems or
  448.                          subsystems that are incompatible with your hardware.
  449.  
  450.      ssssttttaaaalllleeee               All installed subsystems on the target that must be
  451.                          re-installed due to hardware changes.
  452.  
  453.      ffffrrrreeeesssshhhh               The subset of ssssttttaaaalllleeee subsystems that are also on the
  454.                          current distribution.  For example, the command
  455.                          iiiinnnnssssttttaaaallllllll ffffrrrreeeesssshhhh may be used to re-install software that
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  467.  
  468.  
  469.  
  470.                          has been affected by a hardware upgrade.
  471.  
  472.      ttttaaaarrrrggggeeeetttt              All subsytems on the target.
  473.  
  474.      uuuuppppggggrrrraaaaddddeeee,,,, UUUU          All subsystems that have a version installed that is
  475.                          older than the version in the software distribution.
  476.  
  477.      uuuuppppggggrrrraaaaddddeeeedddd,,,, uuuu         Any subsystem on the target that is being removed as
  478.                          part of an installation of a related (typically
  479.                          newer) version of the product from the distribution.
  480.  
  481.      aaaapppppppplllliiiiccccaaaabbbblllleeeeppppaaaattttcccchhhheeeessss   All patches in the distribution that are installable
  482.                          based on the current selections.
  483.  
  484.      oooovvvveeeerrrrllllaaaayyyyssss            All overlay products in the distribution.
  485.  
  486.      iiiinnnnccccoooommmmpppplllleeeetttteeeeoooovvvveeeerrrrllllaaaayyyyssss  The subset of overlay products which cannot be
  487.                          installed because the corresponding base product is
  488.                          not installed, and is not loaded in the distribution
  489.                          view.
  490.  
  491.      mmmmaaaaiiiinnnntttt               This keyword may only be used with the command
  492.                          "install maint" and is used to switch from the
  493.                          feature stream to the maintenance stream.  This
  494.                          command will change the setting of the "stream"
  495.                          preference to "maint", clear the current selections,
  496.                          set the "neweroverride" preference to "on", and make
  497.                          the standard upgrade selections (see the ssssttttaaaannnnddddaaaarrrrdddd
  498.                          keyword), plus downgrade selections, necessary for
  499.                          switching to the maintenance stream.  This command
  500.                          should only be used when "stream" is currently set to
  501.                          "feature" and after opening a distribution containing
  502.                          maintenance products.
  503.  
  504.      ffffeeeeaaaattttuuuurrrreeee             This keyword may only be used with the command
  505.                          "install feature" and is used to switch from the
  506.                          maintenance stream to the feature stream.  This
  507.                          command will change the setting of the "stream"
  508.                          preference to "feature", clear the current
  509.                          selections, and make the standard upgrade selections
  510.                          (see the ssssttttaaaannnnddddaaaarrrrdddd keyword) necessary for switching to
  511.                          the maintenance streams.  This command should only be
  512.                          used when "stream" is currently set to "maint" and
  513.                          after opening a distribution containing feature
  514.                          products.
  515.  
  516. SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNNSSSS FFFFIIIILLLLEEEE
  517.      A sssseeeelllleeeeccccttttiiiioooonnnnssss----ffffiiiilllleeee can be used to specify the distribution(s) and the
  518.      selections for a single installation session.  Blank lines and comment
  519.      lines that begin with a pound-sign (####) are ignored.  All other lines must
  520.      be selections file directives.
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  533.  
  534.  
  535.  
  536.      The software distribution is specified using the ffffrrrroooommmm directive.  This
  537.      directive can be omitted from the selections file if the distribution has
  538.      already been read and the user uses the aaaaddddmmmmiiiinnnn llllooooaaaadddd command.  A selections
  539.      file can contain multiple distribution directives.
  540.  
  541.           ffffrrrroooommmm _d_i_s_t_r_i_b_u_t_i_o_n
  542.           ffffrrrroooommmm _d_i_s_t_d_i_r_1 _d_i_s_t_d_i_r_2
  543.           ffffrrrroooommmm ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt
  544.           ffffrrrroooommmm _h_o_s_t::::_d_i_s_t_r_i_b_u_t_i_o_n
  545.           ffffrrrroooommmm _u_s_e_r@_h_o_s_t::::_d_i_s_t_r_i_b_u_t_i_o_n
  546.           ffffrrrroooommmm _h_t_t_p://_s_e_r_v_e_r/_d_i_s_t_d_i_r/_f_i_l_e._t_a_r_d_i_s_t
  547.  
  548.      _i_n_s_t preference values can be specified for the installation session by
  549.      using the sssseeeetttt directive.  These directives can appear anywhere in the
  550.      file and all preference directives are interpreted together in the order
  551.      that they appear.
  552.  
  553.           sssseeeetttt _p_r_e_f_e_r_e_n_c_e _v_a_l_u_e
  554.  
  555.      The product/subsystem selections for the installation session are
  556.      specified using the selections directives.  The selections directives can
  557.      appear anywhere in the file and all selections directives are interpreted
  558.      together in the order that they appear.  The directives are specified
  559.      using their abbreviated forms, and include iiii (install), rrrr (remove), and kkkk
  560.      (do not remove or install).  These directives take one or more arguments
  561.      that can be a product or subsystem name ((wildcards are permitted), or
  562.      selection keyword described above.
  563.  
  564.           i eoe.sw.cdrom
  565.           i default eoe.sw32.*
  566.           i installable patches
  567.  
  568.           k conflicting
  569.           k *
  570.  
  571.           r *.books.* *.man.*
  572.  
  573.  
  574.  
  575. KKKKEEEEEEEEPPPP FFFFIIIILLLLEEEE
  576.      A kkkkeeeeeeeeppppffffiiiilllleeee can be used to prevent unwanted products from being marked for
  577.      default installation.  If the file /_v_a_r/_i_n_s_t/._k_e_e_p_f_i_l_e exists, its
  578.      contents are processed each time a new distribution is loaded.  The
  579.      keepfile lists new (N) products, images, or subsystems that are not to be
  580.      marked for default installation.  Upgrade (U) subsystems are not affected
  581.      by the keepfile.  The keepfile only affects the initial selections made
  582.      by inst or swmgr when a distribution is loaded.
  583.  
  584.      The _i_n_s_t command aaaaddddmmmmiiiinnnn uuuuppppddddaaaatttteeeekkkkeeeeeeeeppppffffiiiilllleeee updates the keepfile with respect
  585.      to the current selections.  New default subsystems that are not selected
  586.      for installation are appended to the keepfile.
  587.  
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  599.  
  600.  
  601.  
  602.      The keepfile contains one pattern per line.  Only the first whitespace-
  603.      separated pattern on each line is considered.  A wildcard character, ****,
  604.      can be used in the pattern.  For example eoe.books.* turns off default
  605.      installation of all new subsystems in the eoe.books image.  Comments
  606.      beginning with #### and ending with a newline are ignored.
  607.  
  608. TTTTAAAARRRRDDDDIIIISSSSTTTT FFFFIIIILLLLEEEE
  609.      A ttttaaaarrrrddddiiiisssstttt ffffiiiilllleeee is a distribution, encoded as a _t_a_r(_1_m) file.  A tardist
  610.      file can be used to distribute a small product or set of products for
  611.      installation over a network.
  612.  
  613.      When the specified distribution is a tardist file, _i_n_s_t and _s_w_m_g_r unpack
  614.      the distribution into a temporary directory (in /var/tmp), and the
  615.      tardist file's length is zeroed to save space.  Once the installation has
  616.      completed, _i_n_s_t and _s_w_m_g_r give you the option of deleting the temporary
  617.      distribution or saving it for future use.
  618.  
  619.      If you decide to save the distribution for later use, it is usually saved
  620.      in the directory /usr/dist (normally expected to be a world-writable
  621.      directory for unpacking and storing distributions).  However, you can
  622.      save the distribution to another directory if desired.
  623.  
  624.      Tardist files are intended to be used to install distributions located on
  625.      the World Wide Web.  Normally a page will be created with a link to a
  626.      selections file.  The selections file will specify a tardist file (as a
  627.      URL).  Your web browser (e.g., _n_e_t_s_c_a_p_e) will download the selections
  628.      file and invoke _s_w_m_g_r.  _S_w_m_g_r will read the selections file, download the
  629.      specified tardist file, unpack the distribution, and install the
  630.      software.
  631.  
  632.      Tardist files must have the extension ._t_a_r_d_i_s_t in order to be recognized
  633.      as such by _i_n_s_t, _s_w_m_g_r, and web browsers (e.g., _n_e_t_s_c_a_p_e).
  634.  
  635. FFFFIIIILLLLEEEESSSS
  636.      /var/inst/.swmgrrc   most recent values of permanent sssseeeetttt options
  637.      /var/inst/.keepfile  new subsystems not selected for default install
  638.      /var/inst/help1      source for online help
  639.      /var/inst/INSTLOG    log of installation sessions
  640.      /var/inst/hist       database of the files installed on your workstation
  641.                           by inst and swmgr.
  642.      /var/inst/_p_r_o_d_u_c_t    binary files, each describing an installed product
  643.      /usr/dist            directory, writable by the user, in which the
  644.                           contents of the tardist can be saved
  645.      /usr/lib/libwio.so   http protocol support libraries
  646.      /usr/lib32/libwio.so
  647.  
  648. PPPPRRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  649.      A number of preferences are available for customizing _i_n_s_t and _s_w_m_g_r.
  650.      Preferences are loaded from /_v_a_r/_i_n_s_t/._s_w_m_g_r_r_c, /._s_w_m_g_r_r_c, ~/._s_w_m_g_r_r_c,
  651.      and from the command line, with command-line definitions having the
  652.      highest precedence.
  653.  
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  665.  
  666.  
  667.  
  668.      The modifiers in the following descriptions are:
  669.  
  670.      iiiinnnnsssstttt----oooonnnnllllyyyy    used only by _i_n_s_t
  671.      sssswwwwmmmmggggrrrr----oooonnnnllllyyyy   used only by _s_w_m_g_r
  672.      ppppeeeerrrrmmmmaaaannnneeeennnntttt    saved across sessions
  673.      eeeexxxxppppeeeerrrrtttt       for experts only
  674.      rrrreeeeaaaaddddoooonnnnllllyyyy     cannot be modified by the user
  675.      bbbboooooooolllleeeeaaaannnn      An on/off value (true/false may also be used)
  676.  
  677.      aaaabbbboooorrrrtttt____ccccmmmmddddffffiiiilllleeee____oooonnnn____eeeerrrrrrrroooorrrr
  678.                   Abort command-file installation (-c) on errors
  679.                   boolean, default: true (inst-only expert)
  680.                   Controls how errors are handled during command-file (-c)
  681.                   installations.  If "on" (the default) the installation stops
  682.                   after an error and present an interrupt menu.  If "off",
  683.                   commands the remaining commands in the command-file are
  684.                   executed despite any errors.  In all cases errors are
  685.                   reported in /var/inst/INSTLOG. See also abort_on_error.
  686.  
  687.  
  688.      aaaabbbboooorrrrtttt____oooonnnn____eeeerrrrrrrroooorrrr
  689.                   Abort automatic installation on errors
  690.                   boolean, default: off (inst-only permanent expert)
  691.                   Controls how errors are handled during automatic (-a)
  692.                   installations.  If "on" the installation terminates
  693.                   immediately.  If "off" (the default) the installation
  694.                   continues. In all cases errors are reported in
  695.                   /var/inst/INSTLOG. See also abort_cmdfile_on_error.
  696.  
  697.  
  698.      aaaallllllll____aaaarrrrcccchhhhiiiitttteeeeccccttttuuuurrrreeeessss
  699.                   Install all architectures
  700.                   boolean, default: off (readonly)
  701.                   Controls whether files for all architectures are installed.
  702.                   This preference applies during diskless share-tree or
  703.                   client-tree installations, and can only be set with the -C
  704.                   command line option.  See client_inst(1).
  705.  
  706.  
  707.      aaaallllwwwwaaaayyyyssss____ccccoooonnnnffffiiiirrrrmmmm____qqqquuuuiiiitttt
  708.                   Confirm quit action
  709.                   boolean, default: off (permanent)
  710.                   Controls whether the user is always asked for confirmation
  711.                   of a quit command.
  712.  
  713.  
  714.      aaaallllwwwwaaaayyyyssss____ppppaaaaggggeeee____iiiinnnnsssstttt
  715.                   Page optional output
  716.                   boolean, default: off (inst-only expert)
  717.                   Controls whether inst output not specifically requested,
  718.                   such as progress messages during actual installation, are
  719.                   paged or displayed non-stop.
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  731.  
  732.  
  733.  
  734.      aaaauuuuttttooooccccoooonnnnffffiiiigggg____oooovvvveeeerrrrhhhheeeeaaaadddd
  735.                   Autoconfig overhead, in bytes
  736.                   integer, default: 286720 (expert)
  737.                   Controls the amount of disk space reserved during the
  738.                   installation for temporary disk space required by
  739.                   autoconfig(1M) to build a new kernel. Under special
  740.                   circumstances when a debug kernel is being built, this value
  741.                   should be doubled. See also "kernel_size_32" and
  742.                   "kernel_size_64".
  743.  
  744.  
  745.      aaaauuuuttttooooddddeeeesssseeeelllleeeecccctttt Automatically de-select failing subsystems
  746.                   default: confirm, choices: on confirm off
  747.                   This preference controls whether to skip
  748.                   installation/removal of subsystems causing certain types of
  749.                   errors during the pre-installation check, after "go" or
  750.                   "start" is issued.  If set to "on", and if no conflicts
  751.                   would result, the failing subsystems are automatically de-
  752.                   selected, and the installation is re-tried.  If set to
  753.                   "confirm" (the default), the user is prompted before
  754.                   deselecting.  If set to "off", no de-selecting is attempted.
  755.                   Currently only NFS-readonly errors are handled in this
  756.                   fashion, as may occur when books and manual pages are NFS-
  757.                   mounted from another host, and you attempt to install
  758.                   documentation locally.
  759.  
  760.  
  761.      aaaauuuuttttoooommmmaaaattttiiiicccc    Automatic installation
  762.                   boolean, default: off
  763.                   Controls whether the installation proceeds without user
  764.                   intervention.
  765.  
  766.  
  767.      aaaauuuuttttooooppppaaaattttcccchhhhsssseeeelllleeeecccctttt
  768.                   Automatic patch selections
  769.                   boolean, default: on
  770.                   Controls whether installable patches are automatically
  771.                   selected when the appropriate base subsystem is installed or
  772.                   selected for install.  When this preference is "on", patches
  773.                   marked for install will be automatically deselected when the
  774.                   associated base subsystem is marked for removal or
  775.                   deselected for install.
  776.  
  777.  
  778.      aaaauuuuttttoooosssseeeelllleeeecccctttt   Automatic installation selections
  779.                   boolean, default: on
  780.                   Controls whether initial selections are made from the list
  781.                   of subsystems to be installed whenever a new distribution is
  782.                   opened.  Unless overridden by other means, such as the -I,
  783.                   -R, -K, and -u command line options, this will be all
  784.                   upgrade (U) subsystems and all new default (Nd) subsystems
  785.                   in the distribution.
  786.  
  787.  
  788.  
  789.                                                                        PPPPaaaaggggeeee 11112222
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  797.  
  798.  
  799.  
  800.      bbbbaaaacccckkkkggggrrrroooouuuunnnndddd   Background the application
  801.                   boolean, default: on (swmgr-only permanent expert)
  802.                   Controls whether SoftwareManager is run in the foreground or
  803.                   in the background when invoked from a shell.
  804.  
  805.  
  806.      bbbbeeeeeeeepppp         Beep when installation completes
  807.                   boolean, default: on (permanent)
  808.                   Controls whether or not an audible "beep" signal is issued
  809.                   whenever an installation is successfully completed.
  810.  
  811.  
  812.      bbbbuuuussssyyyy____cccchhhheeeecccckkkk   Busy file space checking
  813.                   boolean, default: on (expert)
  814.                   Controls whether busy files (those which are currently
  815.                   accessed by executing processes) are considered during the
  816.                   pre-installation space check. If busy files are removed or
  817.                   overwritten during the installation, their disk blocks are
  818.                   not immediately reclaimed by the operating system. Closing
  819.                   other applications before a live-install may be required in
  820.                   order for the disk space requirements to be met.  In the
  821.                   miniroot, the busy check is always skipped.
  822.  
  823.  
  824.      cccchhhheeeecccckkkkppppooooiiiinnnntttt____rrrreeeessssttttaaaarrrrtttt
  825.                   Automatically restart install if set
  826.                   boolean, default: off (expert)
  827.                   Used for checkpoint restarting. Automatically restart
  828.                   installation if set.
  829.  
  830.  
  831.      cccchhhheeeecccckkkkppppooooiiiinnnntttt____rrrreeeessssttttaaaarrrrtttt____mmmmooooddddeeee
  832.                   Override normal checkpoint restart mode
  833.                   string, default: NULL
  834.                   Specifies the initial user interface mode used for
  835.                   checkpoint restarting. Brings up SoftwareManager in a
  836.                   specific mode, overriding any value set by the user in
  837.                   "custom_startup_mode".
  838.  
  839.  
  840.      cccchhhheeeecccckkkkppppooooiiiinnnntttt____sssseeeelllleeeeccccttttiiiioooonnnnssss
  841.                   Checkpoint before go as well as during go
  842.                   boolean, default: off (permanent expert)
  843.                   Controls whether or not to checkpoint the selections during
  844.                   the selection process. This is useful when making complex
  845.                   selections worth saving.
  846.  
  847.  
  848.      cccclllleeeeaaaarrrrpppprrrroooommmmpppptttt  Clear the "more?" prompt
  849.                   boolean, default: on (inst-only permanent)
  850.                   Controls the way in which some prompts are displayed.
  851.                   Certain operations use "throw away" prompts that are usually
  852.  
  853.  
  854.  
  855.                                                                        PPPPaaaaggggeeee 11113333
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  863.  
  864.  
  865.  
  866.                   cleared by backspacing, then overwritten with spaces. For
  867.                   terminals that can't clear prompts in this way, it is more
  868.                   appropriate to just move to the next line. Set clearprompt
  869.                   "off" to use the simple case.  It is "on" by default and
  870.                   saved from session to session.
  871.  
  872.  
  873.      ccccoooolllluuuummmmnnnnssss      Number of columns in tty display
  874.                   integer, default: 0 (inst-only permanent)
  875.                   The "columns" preference is not supported in this release,
  876.                   but will be supported in a future release. In this release
  877.                   the number of columns is automatically detected by inst (if
  878.                   possible), but cannot be overridden.
  879.  
  880.  
  881.      ccccoooonnnnffffiiiirrrrmmmm____nnnnffffssss____iiiinnnnssssttttaaaallllllllssss
  882.                   Confirm installs onto nfs-mounted filesystems
  883.                   boolean, default: on (permanent)
  884.                   Controls installs onto nfs-mounted filesystems. If set to
  885.                   "on", the user is asked to confirm any installations to
  886.                   nfs-mounted directories located on another host.  When set
  887.                   to "off", inst or SoftwareManager will install on to nfs-
  888.                   mounted filesystems as long as the user has the necessary
  889.                   permissions.
  890.  
  891.  
  892.      ccccoooonnnnffffiiiirrrrmmmm____qqqquuuuiiiitttt Confirm quit if pending actions
  893.                   boolean, default: on (permanent)
  894.                   Controls whether the user is notified that install/remove
  895.                   actions are pending when quitting.
  896.  
  897.  
  898.      ccccuuuussssttttoooommmm____ssssttttaaaarrrrttttuuuupppp____mmmmooooddddeeee
  899.                   SoftwareManager initial selections mode
  900.                   default: off, choices: off distribution always (permanent
  901.                   expert)
  902.                   Controls how SoftwareManager is initially presented.
  903.                   Possible values are: "off" - always start in automatic mode;
  904.                   "distribution" - start in custom-selections mode if a
  905.                   distribution has been specified, otherwise in automatic
  906.                   mode; "always" - start in custom-selections mode if a
  907.                   distribution has been specified, otherwise in manage-
  908.                   installed-software mode.
  909.  
  910.  
  911.      ddddeeeebbbbuuuugggg____mmmmeeeennnnuuuu   Debug menu
  912.                   boolean, default: off (swmgr-only)
  913.                   Controls whether the debug menu is available in swmgr.
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.                                                                        PPPPaaaaggggeeee 11114444
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  929.  
  930.  
  931.  
  932.      ddddeeeeffffaaaauuuulllltttt____ccccoooonnnnffffiiiigggg
  933.                   Force default configuration files
  934.                   boolean, default: off (permanent expert)
  935.                   Controls whether to override the normal configuration file
  936.                   rules, and install ALL the configuration files from the
  937.                   distribution. If the user has modified these files, they are
  938.                   first saved with a ".O" suffix.
  939.  
  940.  
  941.      ddddeeeeffffaaaauuuulllltttt____ddddiiiisssstttt The name of the default distribution from which to read.
  942.                   string, default: NULL (readonly)
  943.                   If no distribution is supplied by the user on the command
  944.                   line, this is used as the default installation location if
  945.                   set. See also "dist" and "distribution".
  946.  
  947.  
  948.      ddddeeeeffffaaaauuuulllltttt____sssshhhhaaaarrrreeeeddddiiiirrrrssss
  949.                   Default share directories
  950.                   string, default: /usr (readonly expert)
  951.                   Contains the list of default share directories used in a
  952.                   diskless share-tree or client-tree installation.
  953.  
  954.  
  955.      ddddeeeellllaaaayyyy____ccccoooonnnnfffflllliiiiccccttttssss
  956.                   Controls when certain conflicts are presented
  957.                   default: ask, choices: ask on off
  958.                   Controls when certain "delayable" conflicts are presented to
  959.                   the user. Currently, only particular incompat conflicts may
  960.                   be delayed. The default behavior, "ask", will query the user
  961.                   when the first delayable conflict is presented. At that
  962.                   time, the user will have the option of resolving the
  963.                   conflict before the installation or prior to exiting. In
  964.                   some installation scenarios, the conflict will have to be
  965.                   delayed since the subsystem(s) necessary to resolve the
  966.                   conflict are not on the current distribution. After making a
  967.                   choice, this behavior will continue for the remainder of the
  968.                   installation session or until the preference value is
  969.                   explicitly changed. An "on" value will always present the
  970.                   delayable conflicts prior to exiting. An "off" selection
  971.                   will present all conflicts, including the delayable variety,
  972.                   prior to installation. This preference is not saved from
  973.                   session to session. To make this preference persistent, add
  974.                   "delay_conflicts:" and the desired value to the .swmgrrc
  975.                   file.
  976.  
  977.  
  978.      ddddeeeellllaaaayyyy____eeeexxxxiiiittttooooppppssss
  979.                   Controls when exitops are executed
  980.                   boolean, default: off (permanent)
  981.                   Controls when exitops are executed. When this preference is
  982.                   "off", the default case, exitops are executed immediately
  983.                   after all files are installed and before control is returned
  984.  
  985.  
  986.  
  987.                                                                        PPPPaaaaggggeeee 11115555
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  995.  
  996.  
  997.  
  998.                   to the user. When this preference is "on", the exitops will
  999.                   not be executed until the user quits. If the user interrupts
  1000.                   an installation and chooses to save the exitops for later
  1001.                   execution, any unexecuted exitops will be executed upon
  1002.                   exiting the application.
  1003.  
  1004.  
  1005.      ddddeeeellllaaaayyyy____iiiiddddbbbb____rrrreeeeaaaadddd
  1006.                   Delay reading of distribution idb files.
  1007.                   default: default, choices: default on off
  1008.                   If set to "on", inst will delay reading of the distribution
  1009.                   idb files until after the Go/Start command is initiated.
  1010.                   This will result in significant speedup when reading large
  1011.                   distributions and less memory usage by inst or swmgr since
  1012.                   only necessary idb lines will be read into memory. Commands
  1013.                   such as "admin files" that require access to the
  1014.                   distribution files will cause the required distribution idb
  1015.                   files to be read.  If set to "off", the reading of the
  1016.                   distribution idb files will never be delayed. If set to
  1017.                   "default", the reading of distribution idb files will be
  1018.                   delayed unless the installation medium is CD. CDs are
  1019.                   treated specially because delaying the reading of idb files
  1020.                   would require extra CD switches in a multi-CD install. If
  1021.                   the user is installing from only 1 CD at a time or is
  1022.                   comfortable with extra CD switches, this preference may be
  1023.                   set to "on".
  1024.  
  1025.  
  1026.      ddddeeeellllaaaayyyyssssppppaaaacccceeeecccchhhheeeecccckkkk
  1027.                   Delay disk space checks until go
  1028.                   boolean, default: off (permanent)
  1029.                   Controls the timing of disk space calculations.  If
  1030.                   "delayspacecheck" is "off", disk space calculation is done
  1031.                   when a "list", "step", or "space" command is given if no
  1032.                   disk space calculation has yet been done for the current
  1033.                   software distribution.  If "delayspacecheck" is "on", disk
  1034.                   space calculation is deferred until the "go" or "space"
  1035.                   commands are given.  When "delayspacecheck" is "on", no disk
  1036.                   space information is displayed by the "list" or "step"
  1037.                   commands.
  1038.  
  1039.  
  1040.      ddddeeeettttaaaaiiiillllssssppppaaaacccceeeecccchhhheeeecccckkkk
  1041.                   Detailed space checking
  1042.                   boolean, default: off (permanent)
  1043.                   Controls the data used for disk space calculations. If
  1044.                   "detailspacecheck" is "on", size and type of every file
  1045.                   installed on the system via inst is obtained by stat-ing the
  1046.                   file on the disk. If "detailspacecheck" is "off", the state
  1047.                   of every file is assumed to be the same as that saved in the
  1048.                   history database and that information is used to make the
  1049.                   disk space calculations. "detailspacecheck" is slower, but
  1050.  
  1051.  
  1052.  
  1053.                                                                        PPPPaaaaggggeeee 11116666
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1061.  
  1062.  
  1063.  
  1064.                   more accurate.
  1065.  
  1066.  
  1067.      ddddiiiissssaaaabbbblllleeee____kkkkeeeeeeeeppppffffiiiilllleeee
  1068.                   Suppress keepfile processing
  1069.                   boolean, default: off
  1070.                   If set, the normal keepfile processing is skipped. Entries
  1071.                   in $rbase/var/inst/.keepfile will be ignored and the initial
  1072.                   installation selections will be unaffected by the .keepfile
  1073.                   entries.  See the "keepfile" help topic.
  1074.  
  1075.  
  1076.      ddddiiiissssaaaabbbblllleeee____pppprrrreeeerrrreeeeqqqq____hhhhiiiinnnnttttssss
  1077.                   Disable processing of the .prereq_hints file
  1078.                   boolean, default: off
  1079.                   If a .prereq_hints file is found in the distribution
  1080.                   directory, inst/swmgr will read this file and use the
  1081.                   product/version to distribution/CD mapping to help the user
  1082.                   figure out where prereq'd products reside. Turning this
  1083.                   option on disables this processing.
  1084.  
  1085.                   ddddiiiissssaaaabbbblllleeee____rrrreeeeddddiiiirrrreeeecccctttt Ignore redirect file in distribution
  1086.                   boolean, default: off (expert)
  1087.                   Controls behavior when a .redirect file is found in a
  1088.                   distribution.  If "on", the .redirect file is evaluated and
  1089.                   the distribution is redirected as specified. If "off" (the
  1090.                   default), the specified distribution is used. Please note
  1091.                   that setting this preference to "off" may result in some
  1092.                   products being skipped if they have been produced for a
  1093.                   newer version of inst or SoftwareManager. You should not
  1094.                   enable this preference unless you explicitly want to attempt
  1095.                   to view products that are not normally intended for
  1096.                   installation on your OS version or hardware platform.
  1097.  
  1098.  
  1099.      ddddiiiissssaaaabbbblllleeee____rrrreeeellllaaaatttteeeedddd____ddddiiiissssttttssss
  1100.                   Ignore related dists file
  1101.                   boolean, default: off (expert)
  1102.                   If set, inst will ignore any .related_dists file that is
  1103.                   found on the distribution.
  1104.  
  1105.  
  1106.      ddddiiiisssskkkk____aaaavvvvaaaaiiiillll   Override available space on target filesystems
  1107.                   string, default: NULL
  1108.                   This preference specifies the free space (in bytes) used in
  1109.                   disk space calculations. If set to a single value, like
  1110.                   "50M" or "1000" then it will apply to all filesystems. To
  1111.                   set the free space of specific filesystems, use the form:
  1112.                   "fs:size|fs:size|..." For example, a value of
  1113.                   "/:4096|/usr:50M" will result in 4096 bytes available on the
  1114.                   / filesystem, and 50M on /usr.  This preference is used for
  1115.                   debugging only.  See also "disk_blocksize" and
  1116.  
  1117.  
  1118.  
  1119.                                                                        PPPPaaaaggggeeee 11117777
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1127.  
  1128.  
  1129.  
  1130.                   "disk_capacity".
  1131.  
  1132.  
  1133.      ddddiiiisssskkkk____bbbblllloooocccckkkkssssiiiizzzzeeee
  1134.                   Override blocksize of target filesystems
  1135.                   string, default: NULL
  1136.                   This preference specifies an alternate blocksize (in bytes)
  1137.                   used in disk space calculations. If set to a single value,
  1138.                   like "1024", or "4k", then it will apply to all filesystems.
  1139.                   To set the blocksize for specific filesystems, use the form:
  1140.                   "fs:blocksize|fs:blocksize|..." For example, a value of
  1141.                   "/:512|/usr:4k" will result in a blocksize of 512 bytes on
  1142.                   the / filesystem, and 4096 byes on the /usr filesystem.
  1143.                   Blocksizes should be a multiple of 512 bytes. This
  1144.                   preference is used for debugging only.  See also
  1145.                   "disk_avail" and "disk_capacity".
  1146.  
  1147.  
  1148.      ddddiiiisssskkkk____ccccaaaappppaaaacccciiiittttyyyy
  1149.                   Override capacity of target filesystems
  1150.                   string, default: NULL
  1151.                   This preference specifies an alternate filesystem size (in
  1152.                   bytes) used in disk space calculations. If set to a single
  1153.                   value, like "50M" or "500k" then it will apply to all
  1154.                   filesystems. To set the size of specific filesystems, use
  1155.                   the form: "fs:size|fs:size|..." For example, a value of
  1156.                   "/:300k|/usr:100M|/d2:100000" will result in a size of 300
  1157.                   kilobytes on the / filesystem, 100 megabytes on /usr, and
  1158.                   100000 bytes on /d2.  This preference is used for debugging
  1159.                   only.  See also "disk_avail" and "disk_blocksize".
  1160.  
  1161.  
  1162.      ddddiiiisssskkkklllleeeessssssss     Diskless mode
  1163.                   default: none, choices: none share client (readonly)
  1164.                   Controls whether the tool is operating on a normal (non-
  1165.                   diskless) tree, a diskless share tree, or a diskless client
  1166.                   tree.
  1167.  
  1168.  
  1169.      ddddiiiissssppppllllaaaayyyy____ssssiiiizzzzeeee Units for product sizes
  1170.                   default: kbytes, choices: bytes blocks kbytes (inst-only)
  1171.                   Controls the units (bytes, kilobytes, or 512-byte blocks)
  1172.                   used to display product sizes.
  1173.  
  1174.  
  1175.      ddddiiiisssstttt         Most recent distribution source
  1176.                   string, default: NULL (permanent)
  1177.                   Each time product descriptions are read, the current
  1178.                   software distribution source (see help from) becomes the
  1179.                   value of "dist".  (A product name, if included in the "from"
  1180.                   argument, is not saved in "dist".)  You can use the value of
  1181.                   "dist" in your "from" commands using the syntax "$dist", for
  1182.  
  1183.  
  1184.  
  1185.                                                                        PPPPaaaaggggeeee 11118888
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1193.  
  1194.  
  1195.  
  1196.                   example "from $dist/eoe2". The command "from none" results
  1197.                   in no distribution being read, and sets the view to target
  1198.                   for browsing or removing installed software. The value of
  1199.                   dist is saved from session to session.
  1200.  
  1201.  
  1202.      ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn The name of the distribution supplied by the user.
  1203.                   string, default: NULL (readonly)
  1204.                   This is the name of the distribution supplied by the user on
  1205.                   the command line. See also "dist".
  1206.  
  1207.  
  1208.      ddddrrrryyyyrrrruuuunnnn       Dryrun mode
  1209.                   boolean, default: off
  1210.                   Controls whether operating in dryrun mode. In this mode, the
  1211.                   names of files which would have otherwise been installed or
  1212.                   removed are displayed. Even with dryrun mode enabled, some
  1213.                   configuration files in $rbase/var/inst may be created or
  1214.                   written and temp directories (/usr/tmp,/var/tmp) under
  1215.                   $rbase will be created if necessary.
  1216.  
  1217.  
  1218.      eeeennnnaaaabbbblllleeee____aaaauuuuttttoooommmmiiiinnnniiiirrrrooooooootttt____ccccoooommmmppppaaaattttiiiibbbbiiiilllliiiittttyyyy
  1219.                   Create 6.3/6.4 compatible command file
  1220.                   boolean, default: off
  1221.                   This option controls whether the command file created for
  1222.                   autominiroot installations is compatible with the 6.3/6.4
  1223.                   miniroot.  This option is only required if doing an
  1224.                   autominiroot install from CD using a 6.3/6.4 miniroot.
  1225.  
  1226.  
  1227.      eeeerrrrrrrroooorrrr____ccccoooorrrreeeedddduuuummmmpppp
  1228.                   Force coredump on X errors
  1229.                   boolean, default: off (swmgr-only)
  1230.                   Controls whether errors in the X Windows interface result in
  1231.                   an immediate coredump.
  1232.  
  1233.  
  1234.      eeeexxxxcccclllluuuussssiiiioooonnnnssss   List of excluded files
  1235.                   string, default: NULL (expert)
  1236.                   This preference holds the list of excluded files, separated
  1237.                   by whitespace or the '|' character. Excluded files (and, for
  1238.                   directories, their descendents) are not installed or removed
  1239.                   during a "go".  A value of "none" indicates no exclusions
  1240.                   are in effect.  The -X command line option may also be used
  1241.                   to specify the exclusions.  If this preference is changed
  1242.                   during an interactive session, any previous disk space
  1243.                   calculations may become out of date. Use the "admin recalc"
  1244.                   command in inst or the "Recalculate Disk Space" command in
  1245.                   SoftwareManager to determine the new space requirements.
  1246.                   See also "restrictions".
  1247.  
  1248.  
  1249.  
  1250.  
  1251.                                                                        PPPPaaaaggggeeee 11119999
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1259.  
  1260.  
  1261.  
  1262.      eeeexxxxiiiittttoooopppp____lllliiiimmmmiiiitttt Exitop output limit
  1263.                   integer, default: 100000 (expert)
  1264.                   This is the maximum output allowed from exitops (shell
  1265.                   commands executed at the end of the installation). Output
  1266.                   over this limit is not displayed or logged. Also applies to
  1267.                   preops and postops (commands executed immediately before or
  1268.                   after a file is installed) and removeops (executed after a
  1269.                   file is removed). Removeops are only executed when a
  1270.                   subsystem is removed, for example with "versions remove",
  1271.                   but not when a subsystem is upgraded.
  1272.  
  1273.  
  1274.      eeeexxxxttttrrrraaaacccctttt____mmmmooooddddeeee Extract images to original source tree
  1275.                   boolean, default: off (readonly)
  1276.                   Controls whether inst or SoftwareManager operates in extract
  1277.                   mode. In this mode, files are installed under their original
  1278.                   source names (relative to the effective root) used to create
  1279.                   the images. Only regular files (not directories, symlinks,
  1280.                   etc.) are installed.  No conflict checking, rqs processing,
  1281.                   or machtag matching is performed.  This preference must be
  1282.                   set before reading the distribution, preferably on the
  1283.                   command line using the -U option.
  1284.  
  1285.  
  1286.      ffffuuuullllllllmmmmeeeennnnuuuu     Display hidden commands
  1287.                   boolean, default: off (inst-only permanent)
  1288.                   Controls the list of commands shown in menus. If fullmenu is
  1289.                   "off" (the default), the most commonly used commands are
  1290.                   displayed in the menus. If fullmenu is "on", all commands
  1291.                   that are available are shown in the menus, and all the
  1292.                   hidden commands are displayed, too.  This preference changes
  1293.                   only the display of commands, not their availability. It is
  1294.                   "off" by default and saved from session to session.
  1295.  
  1296.  
  1297.      hhhhiiiiddddeeee____iiiimmmmaaaaggggeeee____pppprrrroooodddduuuuccccttttssss
  1298.                   Controls the display of image-level products.
  1299.                   boolean, default: on (permanent expert)
  1300.                   If "hide_image_products" is "on" (the default), image-level
  1301.                   products are not displayed. The value of
  1302.                   "hide_image_products" is saved between installation
  1303.                   sessions.
  1304.  
  1305.  
  1306.      hhhhttttttttpppp____ppppiiiicccckkkkyyyy   Require special format distribution file in an HTTP
  1307.                   distribution.
  1308.                   boolean, default: on (permanent expert)
  1309.                   Require special format distribution file in an HTTP
  1310.                   distribution, rather than trying to adapt to any directory
  1311.                   format the HTTP server may see fit to provide.
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.                                                                        PPPPaaaaggggeeee 22220000
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1325.  
  1326.  
  1327.  
  1328.      iiiinnnnsssstttt____iiiinnnniiiittttiiiiaaaallll____lllleeeevvvveeeellll
  1329.                   Inst product display level
  1330.                   default: subsystem, choices: product subsystem (permanent
  1331.                   expert)
  1332.                   Controls the initial level of products displayed in inst.
  1333.  
  1334.  
  1335.      iiiinnnnsssstttt____tttteeeerrrrsssseeee____mmmmooooddddeeee
  1336.                   Reduced output for scripting
  1337.                   boolean, default: off (inst-only expert)
  1338.                   If set "on", inst output is minimized:  most normal status
  1339.                   and progress messages are suppressed unless explicitly asked
  1340.                   for, but any warnings, errors and explicitly requested
  1341.                   output still appear.  Also forces "page_output" "off",
  1342.                   "show_diskspace" "off", "show_legend" "off",
  1343.                   "show_percent_done" "off", "show_files" "off" and
  1344.                   "verbosity" to the value "1".  Useful for automated scripts
  1345.                   driving inst.  See also the -F<selections-file> command line
  1346.                   option, the inst "admin save" and "admin load" commands, and
  1347.                   the "verbose" preference.
  1348.  
  1349.  
  1350.      iiiinnnnsssstttt____vvvviiiissssiiiibbbblllleeee____pppprrrreeeeffffeeeerrrreeeennnncccceeeessss
  1351.                   Set of optional preferences to display.
  1352.                   multivalue, default: permanent,transient,tty, choices:
  1353.                   permanent transient beginner expert tty gui (inst-only
  1354.                   permanent beginner)
  1355.                   Controls the set of optional preferences displayed with the
  1356.                   "set" command.  See also "show_hidden_preferences".
  1357.  
  1358.  
  1359.      iiiinnnnssssttttaaaallllllll____iiiiddddeeeennnnttttiiiiccccaaaallll____ffffiiiilllleeeessss
  1360.                   Install files even if contents are not new
  1361.                   boolean, default: on (permanent expert)
  1362.                   Controls whether to extract files from the distribution even
  1363.                   if the version on disk has the same size and checksum. If
  1364.                   "install_identical_files" is set to "off" installations are
  1365.                   much faster when little has changed from release to release.
  1366.                   Caution: use this preference only if you are comfortable
  1367.                   with the accuracy of the checksum -r test to determine
  1368.                   whether two files of equal length indeed are identical. See
  1369.                   sum(1m).
  1370.  
  1371.  
  1372.      iiiinnnnssssttttaaaallllllll____mmmmiiiinnnniiiimmmmuuuummmm____oooovvvveeeerrrrllllaaaayyyy____ffffiiiilllleeeessss
  1373.                   Control number of files installed during overlay installs
  1374.                   boolean, default: true
  1375.                   This option seeks to minimize the number of files that are
  1376.                   installed when the user installs an overlay product.
  1377.                   Specifically, if the currently installed stream and the
  1378.                   stream to be installed are derived from the same base
  1379.                   product, only the minimum required number of base product
  1380.  
  1381.  
  1382.  
  1383.                                                                        PPPPaaaaggggeeee 22221111
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1391.  
  1392.  
  1393.  
  1394.                   files are installed.  When set to false, all the base
  1395.                   product files are reinstalled if the base subsystem is
  1396.                   included in the distribution.  If the required base
  1397.                   subsystem is not included in the distribution and this
  1398.                   preference is set to false, the miminum install will still
  1399.                   be attempted if no files are required from the base product.
  1400.  
  1401.  
  1402.      iiiinnnnssssttttaaaallllllll____ssssiiiitttteeeessss
  1403.                   List of former install sites
  1404.                   string, default: NULL (permanent expert)
  1405.                   Controls the list of former installation sites displayed.
  1406.  
  1407.  
  1408.      iiiinnnnssssttttaaaallllllll____ssssiiiitttteeeessss____ssssiiiizzzzeeee
  1409.                   Number of items to keep in the install sites list.
  1410.                   integer, default: 10 (permanent)
  1411.                   Controls the number of items in the former installation
  1412.                   sites list.
  1413.  
  1414.  
  1415.      iiiinnnnssssttttmmmmooooddddeeee     Type of installation
  1416.                   default: prototype, choices: normal prototype client
  1417.                   (expert)
  1418.                   Controls certain details of how the installation is
  1419.                   performed. The value is set automatically when the
  1420.                   installation target is initialized. The "instmode"
  1421.                   preference is exported as the environment variable $instmode
  1422.                   for use by exitops. During installs into a bootable target
  1423.                   (miniroot installs into /root, and live installs into /)
  1424.                   instmode has the value "normal". During other installs the
  1425.                   value is "prototype". If the value of "instmode" is changed,
  1426.                   it is recommended that the "admin recalc" command in inst or
  1427.                   the "Recalculate Disk Space" command in SoftwareManager be
  1428.                   used to recalculate space requirements (if any) for the new
  1429.                   UNIX kernel. See also "diskless".
  1430.  
  1431.  
  1432.      iiiinnnntttteeeerrrraaaaccccttttiiiivvvveeee  User interaction control
  1433.                   boolean, default: on
  1434.                   Controls whether the user will be prompted for responses to
  1435.                   questions.
  1436.  
  1437.  
  1438.      kkkkeeeerrrrnnnneeeellll____ssssiiiizzzzeeee____33332222
  1439.                   Size of 32-bit kernel, in bytes
  1440.                   integer, default: 6291456 (expert)
  1441.                   Controls the amount of disk space reserved on 32-bit systems
  1442.                   for /unix, during installations which will cause a new
  1443.                   kernel to be built by autoconfig(1M). See also
  1444.                   "kernel_size_64" and "autoconfig_overhead".
  1445.  
  1446.  
  1447.  
  1448.  
  1449.                                                                        PPPPaaaaggggeeee 22222222
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1457.  
  1458.  
  1459.  
  1460.      kkkkeeeerrrrnnnneeeellll____ssssiiiizzzzeeee____66664444
  1461.                   Size of 64-bit kernel, in bytes
  1462.                   integer, default: 8388608 (expert)
  1463.                   Controls the amount of disk space reserved on 64-bit systems
  1464.                   for /unix, during installations which will cause a new
  1465.                   kernel to be built by autoconfig(1M). See also
  1466.                   "kernel_size_32" and "autoconfig_overhead".
  1467.  
  1468.  
  1469.      lllliiiinnnneeeessss        Number of lines in tty display
  1470.                   integer, default: 0 (inst-only permanent)
  1471.                   The "lines" preference is not supported in this release, but
  1472.                   will be supported in a future release.  In this release the
  1473.                   number of lines is automatically detected by inst (if
  1474.                   possible), but cannot be overridden.
  1475.  
  1476.  
  1477.      lllliiiivvvveeee____iiiinnnnssssttttaaaallllllll Automatically boot miniroot for os installs
  1478.                   default: default, choices: default on off
  1479.                   If set to "on", installs of operating system software will
  1480.                   be allowed in multi-user mode. If set to "default", attempts
  1481.                   to install operating system software in multi-user mode will
  1482.                   automatically shut down the machine and proceed to
  1483.                   automatically boot the miniroot. The user makes selections,
  1484.                   resolves conflicts, and addresses any disk space issues from
  1485.                   multi-user mode. The go/start command from multi-user mode
  1486.                   will initiate the automatic miniroot boot sequence if
  1487.                   operating system software is being installed. If set to
  1488.                   "off", inst or swmgr will always attempt to boot the
  1489.                   miniroot. If no bootable "sa" file is not found in the
  1490.                   distribution directory and a miniroot install is needed,
  1491.                   inst or swmgr will fail with an appropriate error message.
  1492.                   NFS-mounted, remote CDROM, and HTTP distributions are not
  1493.                   bootable. Local CDROM and remote distributions, such as
  1494.                   "bigserver:/dist", are bootable. This preference is only
  1495.                   relevant in multi-user mode when installing into "/". The
  1496.                   user will always be prompted before the machine is actually
  1497.                   shut down.
  1498.  
  1499.  
  1500.      lllloooogggg____ppppaaaannnneeee____hhhheeeeiiiigggghhhhtttt
  1501.                   Height of the log pane in SoftwareManager
  1502.                   integer, default: 125 (swmgr-only)
  1503.                   Specifies the height of the log pane in SoftwareManager.
  1504.  
  1505.  
  1506.      lllloooogggg____ppppaaaannnneeee____lllloooogggg____ssssiiiizzzzeeee
  1507.                   Size of the log pane display
  1508.                   integer, default: 100000 (swmgr-only permanent)
  1509.                   Specifies the maximum amount of text that is displayed in
  1510.                   the log pane before truncation occurs.
  1511.  
  1512.  
  1513.  
  1514.  
  1515.                                                                        PPPPaaaaggggeeee 22223333
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1523.  
  1524.  
  1525.  
  1526.      llllooooggggffffiiiilllleeee____ssssiiiizzzzeeee Size of log file in bytes before recycle
  1527.                   integer, default: 307200 (permanent)
  1528.                   Controls the maximum size of the log file
  1529.                   (/var/inst/INSTLOG).
  1530.  
  1531.  
  1532.      mmmmaaaacccchhhh____ccccllllaaaassssssssffffiiiilllleeee
  1533.                   Mach classes file
  1534.                   string, default: /var/boot/.dl_classes (readonly)
  1535.                   Holds the name of the file containing the hardware chart
  1536.                   used during diskless installations when the -C argument is
  1537.                   specified, requesting that all architectures be installed.
  1538.  
  1539.  
  1540.      mmmmaaaacccchhhh____iiiinnnnffffoooo    Mach tag values
  1541.                   string, default: NULL
  1542.                   Contains the mach tag values that determine which versions
  1543.                   of hardware-specific files to install. Multiple mach
  1544.                   expressions separated by the `|' character are permitted. If
  1545.                   this preference is NULL (the default) the mach values are
  1546.                   automatically derived according to the current hardware
  1547.                   configuration on the system.
  1548.  
  1549.  
  1550.      mmmmaaaacccchhhhffffiiiilllleeee     Name of the standard mach file.
  1551.                   string, default: /var/inst/machfile
  1552.                   Controls the location of the standard machfile.
  1553.  
  1554.  
  1555.      mmmmeeeennnnuuuussss        Print menus
  1556.                   boolean, default: on (inst-only permanent)
  1557.                   Controls the automatic display of menus. Once you are
  1558.                   familiar with the menus, you may wish to disable the
  1559.                   automatic display by setting this preference "off". You can
  1560.                   redisplay the current menu at any time with a "?" command.
  1561.                   It is "on" by default and saved from session to session.
  1562.  
  1563.  
  1564.      mmmmiiiinnnniiiirrrrooooooootttt     Miniroot install
  1565.                   boolean, default: off (readonly)
  1566.                   This flag is on if in the miniroot.
  1567.  
  1568.  
  1569.      mmmmiiiinnnniiiirrrrooooooootttt____ggggrrrraaaapppphhhhiiiiccccssss
  1570.                   Use miniroot graphics
  1571.                   default: default, choices: default on off (inst-only)
  1572.                   Controls whether or not progress is displayed using a
  1573.                   graphical progress box during miniroot installations. The
  1574.                   "default" setting will use graphical display of progress and
  1575.                   other information in the miniroot only during automatic
  1576.                   miniroot installs. A setting of "on" will always display
  1577.                   graphics in the miniroot. A setting of "off" will never
  1578.  
  1579.  
  1580.  
  1581.                                                                        PPPPaaaaggggeeee 22224444
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1589.  
  1590.  
  1591.  
  1592.                   display graphics in the miniroot, instead displaying
  1593.                   information textually. The value of this preference is not
  1594.                   saved between sessions. Note: the graphical progress bar is
  1595.                   not available on all hardware platforms.
  1596.  
  1597.  
  1598.      mmmmoooocccckkkk____sssspppprrrroooocccc   Disable sprocs
  1599.                   boolean, default: off
  1600.                   When set, this disables sproc'ing, so that debugging is
  1601.                   possible. The command is printed on stdout, and execution
  1602.                   terminates until something is read from stdin.
  1603.  
  1604.  
  1605.      nnnneeeettttwwwwoooorrrrkkkk____rrrreeeettttrrrryyyy
  1606.                   Number of network retries
  1607.                   integer, default: 2 (permanent)
  1608.                   Holds the number of successive network timeouts allowed
  1609.                   before giving up on the connection. See "timeout".
  1610.  
  1611.  
  1612.      nnnneeeettttwwwwoooorrrrkkkk____sssseeeeeeeekkkk____tttthhhhrrrreeeesssshhhhoooolllldddd
  1613.                   Controls behavior of remote seek
  1614.                   integer, default: 65536
  1615.                   If seeking forward more than "network_seek_threshold" bytes
  1616.                   in a remote file, re-start the dd process instead of reading
  1617.                   and discarding the intervening bytes. This optimization of
  1618.                   re-starting dd may be disabled by setting
  1619.                   "network_seek_threshold" to zero. If the remote dd does not
  1620.                   support the iseek option, "network_seek_threshold" is always
  1621.                   treated as zero.
  1622.  
  1623.  
  1624.      nnnneeeevvvveeeerrrr____rrrreeeessssiiiizzzzeeee____ppppaaaannnneeee
  1625.                   Do not resize panes when switching selections modes
  1626.                   boolean, default: on (swmgr-only permanent expert)
  1627.                   Controls whether to resize panes when switching between
  1628.                   automatic installation and custom selections or manage
  1629.                   installed software modes in SoftwareManager.
  1630.  
  1631.  
  1632.      nnnneeeewwwweeeerrrroooovvvveeeerrrrrrrriiiiddddeeee
  1633.                   Allows installation of older products
  1634.                   boolean, default: off
  1635.                   Controls whether older subsystems can replace newer
  1636.                   subsystems that are installed. The default value, "off",
  1637.                   prevents you from installing subsystems that are older than
  1638.                   what is already installed (i.e., are marked "O" in "list"
  1639.                   and "step" output).  If you want to replace a subsystem with
  1640.                   an older version, set "neweroverride" to "on". The value of
  1641.                   this preference is not saved from inst session to inst
  1642.                   session.
  1643.  
  1644.  
  1645.  
  1646.  
  1647.                                                                        PPPPaaaaggggeeee 22225555
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1655.  
  1656.  
  1657.  
  1658.      nnnnoooonnnn____rrrrooooooootttt     Not root user can perform installs/removals
  1659.                   boolean, default: off (readonly)
  1660.                   Controls if a non-root user can perform installs/removals.
  1661.  
  1662.  
  1663.      oooovvvveeeerrrrllllaaaayyyy____mmmmooooddddeeee Controls behavior when overlays are loaded
  1664.                   default: none, choices: none ask silent default
  1665.                   (permanent_target)
  1666.                   Controls behavior when overlays are loaded. Set to "ask" to
  1667.                   prompt users to choose an overlay stream if a distribution
  1668.                   contains an overlay. Set to "silent" to maintain the setting
  1669.                   of the "stream" preference and suppress all stream
  1670.                   preference prompts. Set to "default" to maintain the setting
  1671.                   of the "stream" preference but revert to prompting when
  1672.                   there are no remaining stream specific products installed or
  1673.                   in the distribution. A "none" setting indicates that no
  1674.                   stream has been chosen; users will be prompted to choose a
  1675.                   stream.
  1676.  
  1677.  
  1678.      oooovvvveeeerrrrpppprrrriiiinnnntttt    Use overprinting for verbose lists
  1679.                   boolean, default: on (inst-only permanent)
  1680.                   Controls the manner in which filenames are displayed during
  1681.                   installations and removals if the preference "show_files" is
  1682.                   turned on.  When this preference is on, scrolling the
  1683.                   display is significantly reduced by overprinting the file
  1684.                   names on the same line.  If you prefer scrolling as the file
  1685.                   names are displayed, set this preference "off". It is "on"
  1686.                   by default and saved from session to session.
  1687.  
  1688.  
  1689.      oooovvvveeeerrrrrrrriiiiddddeeee____ccccooooaaaarrrrsssseeee____cccchhhheeeecccckkkk
  1690.                   Allow coarse space check to stop install
  1691.                   boolean, default: true
  1692.                   This option allows the coarse, pre-go, space check to stop
  1693.                   the install. By default, this option is disabled since the
  1694.                   coarse space check is not as accurate as the post-go,
  1695.                   detailed space check that is performed after the user types
  1696.                   go in inst or presses start in swmgr.
  1697.  
  1698.  
  1699.      oooovvvveeeerrrrrrrriiiiddddeeee____ssssppppaaaacccceeee____cccchhhheeeecccckkkk
  1700.                   Override space checking
  1701.                   boolean, default: off (expert)
  1702.                   If set to "on", allows "go" despite a disk overflow
  1703.                   condition.
  1704.  
  1705.  
  1706.      ppppaaaaggggeeee____oooouuuuttttppppuuuutttt  Page output
  1707.                   boolean, default: on (inst-only)
  1708.                   Controls whether tty output is managed by a paging mechanism
  1709.                   similar to more(1m).
  1710.  
  1711.  
  1712.  
  1713.                                                                        PPPPaaaaggggeeee 22226666
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1721.  
  1722.  
  1723.  
  1724.      ppppeeeerrrrmmmm____cccchhhheeeecccckkkk   Permissions check
  1725.                   boolean, default: on
  1726.                   Controls whether permissions-checking is performed during
  1727.                   the pre-installation check. When this preference is "on",
  1728.                   the inst or SoftwareManager will inform you during the pre-
  1729.                   installation check whether you have permission to install or
  1730.                   remove files in the affected directories.
  1731.  
  1732.  
  1733.      ppppoooosssstttt____iiiinnnnssssttttaaaallllllll____ddddiiiiaaaalllloooogggg
  1734.                   Ask about quit after install
  1735.                   boolean, default: on (permanent expert)
  1736.                   Controls if a dialog is displayed after an install asking if
  1737.                   the user wants to quit.
  1738.  
  1739.  
  1740.      pppprrrreeeecccciiiioooouuuussss____ffffiiiilllleeeessss
  1741.                   List of precious files
  1742.                   string, default: NULL (expert)
  1743.                   Holds the list of precious file separated by whitespace,
  1744.                   specified on the cmd-line or .swmgrrc. Inst or
  1745.                   SoftwareManager will not overwrite or remove any files which
  1746.                   the user has designated as precious.
  1747.  
  1748.  
  1749.      pppprrrroooommmmppppttttffffoooorrrriiiidddd  Interactive prompt for unknown uid
  1750.                   boolean, default: off (permanent)
  1751.                   Controls whether the user will be interactively queried for
  1752.                   ids corresponding to unknown uids/gids. Unknown uids or gids
  1753.                   result when a passwd or group file does not contain an id
  1754.                   for the given name.  If "off", inst or SoftwareManager will
  1755.                   automatically choose the uids/gids (and write them to
  1756.                   /usr/adm/SYSLOG) based on the value of the "startid"
  1757.                   preference.
  1758.  
  1759.  
  1760.      rrrreeeemmmmooootttteeee____rrrreeeeaaaadddd____ssssiiiizzzzeeee
  1761.                   Remote distribution read buffer size
  1762.                   integer, default: 10240
  1763.                   Controls the size of the buffer used for reading remote
  1764.                   distributions.
  1765.  
  1766.  
  1767.      rrrreeeemmmmoooovvvveeeeppppoooolllliiiiccccyyyy Control remove behavior within inst
  1768.                   default: safe, choices: anything safe
  1769.                   This option controls what the user is allowed to remove from
  1770.                   the distribution view in inst. A setting of "anything"
  1771.                   allows any target products to be marked for removal in the
  1772.                   distribution view. Conversely, a setting of "safe" while in
  1773.                   the distribution view only allows targ products with the
  1774.                   same name as products in the distribution view to be marked
  1775.                   for removal. For example, with a setting of "safe", the
  1776.  
  1777.  
  1778.  
  1779.                                                                        PPPPaaaaggggeeee 22227777
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1787.  
  1788.  
  1789.  
  1790.                   "remove *" operation in the distribution view would only
  1791.                   mark for removal target products that have the same name as
  1792.                   products currently in the distribution view. With a setting
  1793.                   of "anything", "remove *" in the distribution view would
  1794.                   mark all target products for removal, regardless of what
  1795.                   products are in the distribution view.
  1796.  
  1797.  
  1798.      rrrreeeeppppoooorrrrtttt____eeeexxxxiiiitttt____ssssttttaaaattttuuuussss
  1799.                   Set process exit status
  1800.                   boolean, default: off (permanent)
  1801.                   Controls the exit status to be set to various non-zero
  1802.                   values, depending on what caused the exit.
  1803.  
  1804.  
  1805.      rrrreeeessssttttrrrriiiicccctttteeeedddd   Restricted mode
  1806.                   boolean, default: off (inst-only)
  1807.                   This preference controls restricted mode in inst.
  1808.  
  1809.  
  1810.      rrrreeeessssttttrrrriiiiccccttttiiiioooonnnnssss List of restricted files
  1811.                   string, default: NULL (expert)
  1812.                   Holds the list of restricted files, separated by whitespace
  1813.                   or the '|' character. Restricted files (and, for
  1814.                   directories, their descendents) are the only files installed
  1815.                   or removed during a "go". A value of "none" indicates no
  1816.                   restrictions are in effect.  The -Y command line option may
  1817.                   be used to specify the restrictions.  If this preference is
  1818.                   changed during an interactive session, any previous disk
  1819.                   space calculations may become out of date. Use the "admin
  1820.                   recalc" command in inst or the "Recalculate Disk Space"
  1821.                   command in SoftwareManager to determine the new space
  1822.                   requirements.  See also "exclusions".
  1823.  
  1824.  
  1825.      rrrrqqqqssss____oooonnnnllllyyyy     Requickstart mode
  1826.                   boolean, default: off
  1827.                   Controls whether the only operation performed is rqs In this
  1828.                   mode the installation tool will execute any necessary rqs(1)
  1829.                   processing, and then exit. This preference can also be set
  1830.                   with the -Q command line option.
  1831.  
  1832.  
  1833.      rrrrqqqqssss____ttttaaaasssskkkk     Fine-control over rqs(1) processing
  1834.                   default: default, choices: default rqsread rqsall
  1835.                   If set to "rqsread", then only the first rqs phase will be
  1836.                   performed (the rqs registry file is updated).  If set to
  1837.                   "rqsall", then only the second rqs phase will be performed
  1838.                   (executables are requickstarted using the rqs(1) utility).
  1839.                   Otherwise both phases are performed, as necessary, when the
  1840.                   installation tool exits.
  1841.  
  1842.  
  1843.  
  1844.  
  1845.                                                                        PPPPaaaaggggeeee 22228888
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1853.  
  1854.  
  1855.  
  1856.      rrrrqqqqssss____ttttiiiimmmmeeeessssttttaaaammmmpppp
  1857.                   Rqs timestamp
  1858.                   string, default: NULL
  1859.                   If this preference is set, its value is passed to the
  1860.                   rqsall(1) command using the -timestamp argument, during rqs
  1861.                   processing.
  1862.  
  1863.  
  1864.      rrrruuuulllleeeessssoooovvvveeeerrrrrrrriiiiddddeeee
  1865.                   Override any conflict
  1866.                   boolean, default: off
  1867.                   Controls whether conflicts can be overridden.  The default
  1868.                   value, "off", prevents you from installing subsystems that
  1869.                   do not meet specified incompat or prereq rules.  If you want
  1870.                   to override these rules, set "rulesoverride" to "on". This
  1871.                   preference should be used cautiously. "rulesoverride" is not
  1872.                   saved from session to session. NOTE: it is best to first
  1873.                   resolve as many conflicts as possible, and then only as a
  1874.                   last resort use this preference just before "go" or "start"
  1875.                   to overcome the remaining conflicts. After the installation
  1876.                   completes, you are advised to set "rulesoverride" back to
  1877.                   "off" so that conflicts do not go accidentally unnoticed for
  1878.                   the remainder of the session.
  1879.  
  1880.  
  1881.      sssseeeelllleeeeccccttttiiiioooonnnnssss____ppppaaaannnneeee____hhhheeeeiiiigggghhhhtttt
  1882.                   Height of the selections pane
  1883.                   integer, default: 350 (swmgr-only)
  1884.                   Specifies the height of the selections pane.
  1885.  
  1886.  
  1887.      sssseeeetttt____ppppaaaatttthhhh     Control $PATH variable for exitops
  1888.                   default: default, choices: default environment specific
  1889.                   (permanent expert)
  1890.                   Can be set to "default", "environment", or "specific":
  1891.                   "default" - set path to a known path; "environment" - pass
  1892.                   $path in from the environment $PATH (or use the default path
  1893.                   if $PATH is not set); "specific" - use whatever is in the
  1894.                   preference "set_path_specific".
  1895.  
  1896.  
  1897.      sssseeeetttt____ppppaaaatttthhhh____ssssppppeeeecccciiiiffffiiiicccc
  1898.                   Path used for exitops
  1899.                   string, default: NULL (permanent expert)
  1900.                   Controls the path used for exitops.
  1901.  
  1902.  
  1903.      sssshhhhaaaaddddoooowwww____ffffiiiilllleeeessss List of files to shadow
  1904.                   string, default: NULL
  1905.                   Holds the list of shadow files, separated by whitespace,
  1906.                   specified on the command line or .swmgrrc
  1907.  
  1908.  
  1909.  
  1910.  
  1911.                                                                        PPPPaaaaggggeeee 22229999
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1919.  
  1920.  
  1921.  
  1922.      sssshhhhaaaaddddoooowwwwiiiinnnngggg    File shadowing
  1923.                   boolean, default: NULL (readonly)
  1924.                   Controls whether special files are shadowed during a live
  1925.                   (non-miniroot) install.
  1926.  
  1927.  
  1928.      sssshhhhaaaarrrreeeebbbbaaaasssseeee    Root of sharetree in client mode
  1929.                   string, default: NULL
  1930.                   Holds the name of the root of sharetree in client mode.
  1931.  
  1932.  
  1933.      sssshhhhaaaarrrreeeeppppooooiiiinnnnttttssss  Potentially shared, read-only directories.
  1934.                   string, default: /usr/share|/usr/share/Insight
  1935.                   Holds a list of directory names, separated by whitespace or
  1936.                   the '|' character. These should be directory names as listed
  1937.                   in the installation history (if different from the true
  1938.                   pathnames on disk).  As necessary these directories are
  1939.                   tested for write-permission at the beginning of the pre-
  1940.                   installation check.  Other readonly directories (as are
  1941.                   commonly NFS-mounted) take longer to detect the first time.
  1942.                   As new readonly directories are discovered, the sharepoints
  1943.                   preference is automatically updated, to speed-up error
  1944.                   checking in future installations.  If set to "none", or to
  1945.                   an empty string, the sharepoint checking is disabled.
  1946.  
  1947.  
  1948.      sssshhhheeeellllllll        Program to use for "sh" and "shroot"
  1949.                   string, default: /bin/csh (permanent)
  1950.                   Controls what program to use for "sh" and "shroot". It may
  1951.                   be any pathname, and is the name of the IRIX command that is
  1952.                   invoked for "sh" and "shroot" commands. It is normally
  1953.                   /bin/sh or /bin/csh; the default value comes from the SHELL
  1954.                   environment variable. It is saved from session to session.
  1955.  
  1956.  
  1957.      sssshhhhoooorrrrtttt____nnnnaaaammmmeeeessss  Display product name instead of description.
  1958.                   boolean, default: off (permanent)
  1959.                   Controls if the product name is displayed instead of the
  1960.                   product description when the products are listed.
  1961.  
  1962.  
  1963.      sssshhhhoooowwww____ccccoooommmmmmmmaaaannnndddd____ppppaaaannnneeee
  1964.                   Display the command pane on startup
  1965.                   boolean, default: off (swmgr-only)
  1966.                   Controls whether the command pane is shown on startup.
  1967.  
  1968.  
  1969.      sssshhhhoooowwww____ddddiiiisssskkkkssssppppaaaacccceeee
  1970.                   Display diskspace summary
  1971.                   boolean, default: on (inst-only permanent)
  1972.                   Controls whether the diskspace is displayed by the "list",
  1973.                   "step" and "recalculate" commands.  Use the "admin space"
  1974.  
  1975.  
  1976.  
  1977.                                                                        PPPPaaaaggggeeee 33330000
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  1985.  
  1986.  
  1987.  
  1988.                   command to display this summary even when this preference is
  1989.                   set "off".  See also "inst_terse_mode".
  1990.  
  1991.  
  1992.      sssshhhhoooowwww____ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn____ppppaaaannnneeee
  1993.                   Display the distribution pane on startup
  1994.                   boolean, default: on (swmgr-only)
  1995.                   Controls whether the distribution pane is shown on startup.
  1996.  
  1997.  
  1998.      sssshhhhoooowwww____eeeexxxxiiiissssttttiiiinnnngggg____ccccoooonnnnfffflllliiiiccccttttssss
  1999.                   Display pre-existing conflicts
  2000.                   boolean, default: off
  2001.                   Controls whether pre-existing conflicts are displayed or
  2002.                   not.
  2003.  
  2004.  
  2005.      sssshhhhoooowwww____ffffiiiilllleeeessss   Display filenames during install
  2006.                   boolean, default: off (permanent expert)
  2007.                   Controls whether the name of each file is displayed as it is
  2008.                   installed or removed.  See also "overprint", to control
  2009.                   whether these listed filenames are displayed on the same
  2010.                   line or not.  See also "verbose".
  2011.  
  2012.  
  2013.      sssshhhhoooowwww____hhhhiiiiddddddddeeeennnn____pppprrrreeeeffffeeeerrrreeeennnncccceeeessss
  2014.                   Hide or present all preferences
  2015.                   boolean, default: off (permanent expert)
  2016.                   Controls whether the user is presented with the hidden
  2017.                   preferences, in addition to the basic preferences. See also
  2018.                   "inst_visible_preferences" and "swmgr_visible_preferences".
  2019.  
  2020.  
  2021.      sssshhhhoooowwww____lllleeeeggggeeeennnndddd  Display list legend
  2022.                   boolean, default: on (inst-only permanent)
  2023.                   Controls whether the legend is displayed at the beginning of
  2024.                   the output of the "list" command.  See also
  2025.                   "inst_terse_mode".
  2026.  
  2027.  
  2028.      sssshhhhoooowwww____lllliiiinnnntttt    Show distribution consistency errors
  2029.                   boolean, default: off (permanent expert)
  2030.                   Controls whether to display any inconsistencies found while
  2031.                   reading the distribution.
  2032.  
  2033.  
  2034.      sssshhhhoooowwww____lllloooogggg____ppppaaaannnneeee
  2035.                   Display the log pane on startup
  2036.                   boolean, default: off (swmgr-only)
  2037.                   Controls whether the log pane is displayed on startup.
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.                                                                        PPPPaaaaggggeeee 33331111
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  2051.  
  2052.  
  2053.  
  2054.      sssshhhhoooowwww____ppppeeeerrrrcccceeeennnntttt____ddddoooonnnneeee
  2055.                   Display task percentages
  2056.                   boolean, default: on (inst-only expert)
  2057.                   Controls whether percent-done messages are displayed in
  2058.                   inst.  See also "verbose".
  2059.  
  2060.  
  2061.      sssshhhhoooowwww____sssseeeelllleeeeccccttttiiiioooonnnnssss____ppppaaaannnneeee
  2062.                   Display the selections pane on startup
  2063.                   boolean, default: on (swmgr-only)
  2064.                   Controls whether the selections pane is shown on startup.
  2065.  
  2066.  
  2067.      sssshhhhoooowwww____ssssttttaaaatttt____ppppaaaannnneeee
  2068.                   Display the status pane on startup
  2069.                   boolean, default: on (swmgr-only)
  2070.                   Controls whether the status pane is shown on startup.
  2071.  
  2072.  
  2073.      sssshhhhoooowwww____ssssuuuubbbbttttaaaasssskkkkssss
  2074.                   Print tasking information
  2075.                   boolean, default: off
  2076.                   Controls whether detailed information about tasks and sub-
  2077.                   tasks is displayed.
  2078.  
  2079.  
  2080.      sssskkkkiiiipppp____rrrrqqqqssss     Skip the requickstart process entirely
  2081.                   boolean, default: off
  2082.                   Controls whether to skip the requickstart process.  Use this
  2083.                   preference cautiously, since it can cause newly installed
  2084.                   dynamic ELF programs to start-up less quickly.
  2085.  
  2086.  
  2087.      ssssmmmmaaaarrrrtttt____ccccoooonnnnffffiiiigggg____hhhhaaaannnnddddlllliiiinnnngggg
  2088.                   Selectively install config(update) files
  2089.                   boolean, default: on (permanent)
  2090.                   If enabled, config(update) files will not be installed if
  2091.                   the previously installed version has the same size and
  2092.                   checksum as reported by the inst history file
  2093.  
  2094.  
  2095.      ssssppppaaaacccceeee____cccchhhheeeecccckkkk  Controls space checking
  2096.                   boolean, default: on
  2097.                   Controls whether disk space checking is performed.  Use
  2098.                   cautiously, or you can run out of diskspace.
  2099.  
  2100.  
  2101.      ssssppppaaaacccceeee____uuuuppppddddaaaatttteeee____iiiinnnntttteeeerrrrvvvvaaaallll
  2102.                   Seconds between disk space updates
  2103.                   integer, default: 10 (swmgr-only permanent)
  2104.                   Specifies how often the Disk Space area is automatically
  2105.                   updated (in addition to updates that occur when the product
  2106.  
  2107.  
  2108.  
  2109.                                                                        PPPPaaaaggggeeee 33332222
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  2117.  
  2118.  
  2119.  
  2120.                   selections change). If zero is specified, automatic updates
  2121.                   are disabled.
  2122.  
  2123.  
  2124.      ssssttttaaaarrrrttttiiiidddd      Initial id to assign for an unknown uid/gid
  2125.                   integer, default: 60000 (permanent)
  2126.                   This preference is only relevant if promptforid is "off".
  2127.                   Inst or SoftwareManager will automatically assign unknown
  2128.                   uid/gid values based on the value of "startid".  After a
  2129.                   given unknown uid or gid is assigned the value (startid),
  2130.                   the next unknown uid/gid will be assigned (startid - 1), and
  2131.                   the next (startid - 2), etc.  It is recommended that startid
  2132.                   be assigned a value that no current uids/gids possess. If
  2133.                   inst or SoftwareManager automatically assigns a uid or gid
  2134.                   to a file, it will write the mapping to /usr/adm/SYSLOG.
  2135.  
  2136.  
  2137.      ssssttttaaaarrrrttttuuuupppp____ssssccccrrrriiiipppptttt
  2138.                   Control optional installation startup script handling
  2139.                   default: prompt, choices: prompt ignore execute (expert)
  2140.                   This preference is used to control how inst and
  2141.                   SoftwareManager treat the inst.init startup script (if any)
  2142.                   that accompanies the software distribution. If set to
  2143.                   "prompt", the user is prompted before the script is
  2144.                   executed. If set to "ignore", the startup script is ignored.
  2145.                   If set to "execute" the startup script is run without
  2146.                   confirmation from the user. Non-interactive installations
  2147.                   (inst -a or swmgr -a -Vinteractive:off) will fail if a
  2148.                   startup script is present, unless this preference is
  2149.                   explicitly set on the command line with either
  2150.                   -Vstartup_script:ignore or -Vstartup_script:execute. This
  2151.                   preference is not saved across sessions, unless a line such
  2152.                   as "startup_script:ignore" is manually added to the
  2153.                   /var/inst/.swmgrrc file. For security reasons you are
  2154.                   strongly advised against adding the line
  2155.                   "startup_script:execute" to the .swmgrrc file.
  2156.  
  2157.  
  2158.      ssssttttrrrreeeeaaaammmm       Controls type of overlays to be displayed
  2159.                   default: maint, choices: maint feature (permanent_target)
  2160.                   Controls type of overlays to be displayed.  To switch
  2161.                   between streams, normally the inst commands "install maint"
  2162.                   and "install feature", or Install menu in Software Manager,
  2163.                   should be used rather than setting this preference directly.
  2164.                   A setting of "maint" causes feature stream overlay products
  2165.                   to be hidden from the user. A setting of "feature" causes
  2166.                   maintenance stream overlay products to be hidden from the
  2167.                   user. Maintenance stream products and feature stream
  2168.                   products are incompatible with one another. Maintenance
  2169.                   stream products consist of bug fixes and changes required to
  2170.                   support new hardware. Feature stream products consist of bug
  2171.                   fixes and newly introduced features, possibly to take
  2172.  
  2173.  
  2174.  
  2175.                                                                        PPPPaaaaggggeeee 33333333
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  2183.  
  2184.  
  2185.  
  2186.                   advantage of new hardware. Normally, the inst commands
  2187.                   "install maint" and "install feature" should be used to
  2188.                   switch from one stream to the other, because these commands
  2189.                   modify the current selections in addition to setting the
  2190.                   stream preference. In Software Manager, use the Install menu
  2191.                   to switch between streams, after first opening a software
  2192.                   distribution containing feature or maintenance products and
  2193.                   choosing Customize Installation mode.
  2194.  
  2195.  
  2196.      ssssuuuupppppppprrrreeeessssssss____rrrrqqqqssss____eeeerrrrrrrroooorrrrssss
  2197.                   Suppress error message on rqsread/rqsall failure
  2198.                   boolean, default: true
  2199.                   This option suppresses the inst warning message that
  2200.                   accompanies an rqsread(1) or rqsall(1) error. The default is
  2201.                   to suppress the message since there is no loss of
  2202.                   functionality as the result of such a failure.
  2203.  
  2204.  
  2205.      sssswwwwmmmmggggrrrr____iiiinnnniiiittttiiiiaaaallll____lllleeeevvvveeeellll
  2206.                   SoftwareManager product display level
  2207.                   default: product, choices: product subsystem (swmgr-only
  2208.                   permanent expert)
  2209.                   Controls the initial level of products displayed.
  2210.  
  2211.  
  2212.      sssswwwwmmmmggggrrrr____vvvviiiissssiiiibbbblllleeee____pppprrrreeeeffffeeeerrrreeeennnncccceeeessss
  2213.                   Set of optional preferences to display.
  2214.                   multivalue, default: transient,gui, choices: none transient
  2215.                   expert gui tty (swmgr-only permanent beginner)
  2216.                   Controls the set of optional preferences displayed in the
  2217.                   preferences dialog.  See also "show_hidden_preferences".
  2218.  
  2219.  
  2220.      sssswwwwmmmmggggrrrrrrrrcccc____ppppaaaatttthhhh Search path for .swmgrrc preference files
  2221.                   string, default: /var/inst:$rbase/var/inst:$rbase$HOME:$HOME
  2222.                   (expert)
  2223.                   Contains a colon-separated list of directories to search for
  2224.                   preference files, such as ~/.swmgrrc, that contain
  2225.                   preferences to be saved between sessions. The directories
  2226.                   are searched in the order specified. Preference settings in
  2227.                   the last .swmgrrc found have the highest precedence.
  2228.  
  2229.                   Whenever you change the value of a "permanent" preference,
  2230.                   its value will be saved in .swmgrrc (the one most recently
  2231.                   loaded) and will remain set in future inst or
  2232.                   SoftwareManager sessions.
  2233.  
  2234.                   The "swmgrrc_path" can also be modified by setting the
  2235.                   environment variable SWMGRRC_PATH. If the value is "none",
  2236.                   then no .swmgrrc files will be read, or saved.
  2237.  
  2238.  
  2239.  
  2240.  
  2241.                                                                        PPPPaaaaggggeeee 33334444
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  2249.  
  2250.  
  2251.  
  2252.      ssssyyyymmmmlllliiiinnnnkkkk____mmmmooooddddeeee Create a symlink tree
  2253.                   boolean, default: off (readonly)
  2254.                   Controls whether inst or SoftwareManager operates in symlink
  2255.                   mode. In this mode, all files (but not directories, config
  2256.                   files, or noshare files) are installed as absolute symbolic
  2257.                   links pointing to the corresponding file in the real tree.
  2258.                   This preference can only be set on the command line, using
  2259.                   -T<symlink_root>. See "symlink_root".
  2260.  
  2261.  
  2262.      ssssyyyymmmmlllliiiinnnnkkkk____rrrrooooooootttt Root of real tree in symlink mode
  2263.                   string, default: NULL (readonly)
  2264.                   Holds the root of the real tree to which symlinks point.
  2265.                   This preference can only be set on the command line, using
  2266.                   -T<symlink_root>. See "symlink_mode".
  2267.  
  2268.  
  2269.      ssssyyyysssslllloooogggg       Log messages to /var/adm/SYSLOG
  2270.                   boolean, default: off (expert)
  2271.                   Controls whether inst or SoftwareManager will log errors and
  2272.                   warnings to /var/adm/SYSLOG in addition to
  2273.                   /var/inst/INSTLOG.
  2274.  
  2275.  
  2276.      ttttaaaarrrrggggeeeetttt       Location of target tree
  2277.                   string, default: / (readonly)
  2278.                   Holds the name of the root directory on the local filesystem
  2279.                   where files are installed or removed. SoftwareManager and
  2280.                   inst do not install or remove files outside of the target.
  2281.                   Normally during a live installation, the target is /, and in
  2282.                   the miniroot it is /root. The -r command line option may be
  2283.                   used to specify an alternate target.
  2284.  
  2285.  
  2286.      ttttiiiimmmmeeeeoooouuuutttt      Network timeout in seconds
  2287.                   integer, default: 120 (permanent)
  2288.                   Holds the amount of time to wait for a reply from a remote
  2289.                   host.  If the remote machine does not respond after this
  2290.                   time, the request is attempted again. See "network_retry".
  2291.                   The default is two minutes; if your network is particularly
  2292.                   slow, this may not be enough.  If you receive errors
  2293.                   regarding the network timeout, and you believe the access
  2294.                   will succeed if given more time, increase the value of this
  2295.                   preference. The value of timeout is saved from session to
  2296.                   session.
  2297.  
  2298.  
  2299.      ttttoooooooollllnnnnaaaammmmeeee     Name of invoked installation program.
  2300.                   string, default: NULL
  2301.                   Holds the name of the installation program, either "inst" or
  2302.                   "swmgr" (SoftwareManager).
  2303.  
  2304.  
  2305.  
  2306.  
  2307.                                                                        PPPPaaaaggggeeee 33335555
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314. sssswwwwmmmmggggrrrr((((1111MMMM))))                                                            sssswwwwmmmmggggrrrr((((1111MMMM))))
  2315.  
  2316.  
  2317.  
  2318.      ttttrrrraaaacccceeee        Trace debugging
  2319.                   multivalue, default: NULL, choices: none category checkpoint
  2320.                   config conflict constructor cutpoint destructor diskless
  2321.                   dispatcher dist errno file general gui hist http mach malloc
  2322.                   orphan perm prod remote resource rules rqs selection space
  2323.                   stat tape task all
  2324.                   Controls which type of debugging information is displayed.
  2325.                   Can be "all" or any combination of categories. Set to "none"
  2326.                   to disable debugging.
  2327.  
  2328.  
  2329.      vvvveeeerrrrbbbboooosssseeee      Display more detailed output
  2330.                   boolean, default: off (permanent expert)
  2331.                   When set "on", causes more status messages to be displayed.
  2332.                   For finer control of the same facility, see "verbosity".
  2333.                   See also "show_files", "show_percent_done" and
  2334.                   "inst_terse_mode".
  2335.  
  2336.  
  2337.      vvvveeeerrrrbbbboooossssiiiittttyyyy    Message verbosity display threshold
  2338.                   integer, default: 2, choices: 0 to 6 (permanent)
  2339.                   Controls the level of error and related info messages
  2340.                   displayed.  0 for silent, 2 for verbose off (default), 4 for
  2341.                   verbose on, 6 for all messages.  For another way to control
  2342.                   this setting, see "verbose".
  2343.  
  2344.  
  2345.      vvvveeeerrrriiiiffffyyyy____cccchhhheeeecccckkkkssssuuuummmm
  2346.                   Verify checksum of file during install
  2347.                   boolean, default: on (permanent expert)
  2348.                   During the installation, verify the checksum of each file as
  2349.                   it is uncompressed or read from the archive.
  2350.  
  2351.  
  2352.      wwwwrrrraaaappppmmmmooooddddeeee     Wrap/truncate long lines in display
  2353.                   default: wrap, choices: wrap truncate (inst-only permanent)
  2354.                   Controls the display of long subsystem descriptions by the
  2355.                   "list" command. In "wrap" mode, the part of the description
  2356.                   that overflows the right margin of the screen is shown
  2357.                   indented on the next line. In "truncate" mode, the line is
  2358.                   truncated near the right margin. The "step" command always
  2359.                   uses truncate mode, regardless of the setting of this
  2360.                   preference. It is "wrap" by default and saved from session
  2361.                   to session.
  2362.  
  2363.  
  2364. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  2365.      distcp(1M), inst(1M), showfiles(1M), showprods(1M), versions(1M),
  2366.      netscape(1M), tar(1M) and _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d
  2367.      _L_i_c_e_n_s_i_n_g.
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.                                                                        PPPPaaaaggggeeee 33336666
  2374.  
  2375.  
  2376.  
  2377.